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内 容 提要 


软件 质量 ， 不 但 依赖 于 架构 及 项 目 管理 ， 而 且 与 代码 质量 紧密 相 
天。 这 一 点 ， 无 论 征 敏捷 开发 流派 还 是 传统 开发 流派 ， 都 不 得 不 承 
认 。 

本 书 提出 一 种 观念 : 代码 质量 与 其 整洁 度 成 正比 。 干 净 的 代码 ， 
既 在 质量 上 较为 可 靠 ， 也 为 后 期 维护 、 升 级 葛 定 了 民 好 基础 。 作 为 编 
程 领 域 的 佼佼 者 ， 本 书 作 者 给 出 了 一 系列 行 之 有 效 的 整洁 代码 操作 实 
践 。 这 些 实践 在 本 书 中 体现 为 一 条 条 规则 (或 称 “ 启 示 ”) ， 并 辅 以 来 
目 现实 项 目的 正 、 反 两 面 的 范例 。 只 要 章 循 这 些 规则 ， 残 能 编写 出 干 
净 的 代码 ， 从 而 有 效 所 升 代码 质量 。 

本 书 阅读 对 象 为 一 切 有 志 于 改善 代码 质量 的 程序 员 及 撤 术 经 理 。 
书 中 介绍 的 规则 均 来 目 作 者 多 年 的 实践 经 给， 涵盖 从 命名 到 重 构 的 多 
个 编程 方面 ， 虽 为 一 “家 ”之 言 ， 然 诚 有 可 资 借鉴 的 价值 。 
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FIR (Ga-Jol) 是 在 丹麦 最 受 欢迎 的 糖果 品种 之 一 ， 它 浓郁 的 甘 
草 味道 ， 完 美 地 弥补 了 此 地 潮湿 且 时 常 寒冷 的 天 气 。 对 于 我 们 这 些 丹 
才 人 ， 乐 嚼 的 妙 处 还 在 于 包装 盒 项 上 印 制 的 哲 言 划 语 。 今 早 我 天 了 一 
包 两 件 装 ， 在 其 包装 盒 上 发 现 这 人 句 丹 麦 谚语 : 

ZE rlighed i små ting er ikke nogen lille ting. 

“小 处 诚实 非 小 事 。” 这 人 句 话 正好 是 我 想 在 这 里 说 的 。 以 小 见 大 。 
本 书写 到 了 一 些 价值 殊 胜 的 小 主题 。 

神 在 细节 之 中 ， 建 筑 师 Ludwig mies van der Rohe (路 德 维 希 :密斯 : 
范 : 德 : 罗 ) [了 如 是 说 。 这 句 话 引发 了 有 关 软 件 开 发 、 特 别 是 敏捷 软件 
开发 中 架构 所 处 地 位 的 若干 争论 。 鲍 盈 (Bob) [2] 和 我 时 常 发 现 目 己 
沉 酒 于 此 类 对 话 中 。 没 错 ，Ludwig mies van der Rohe 的 确 专注 于 效用 
和 基于 宏伟 架构 之 上 的 永恒 建筑 形式 。 然 而 ， 他 也 为 自己 设 计 的 每 所 
房屋 挑选 每 个 门 把 手 。 为 什么 ?因为 小 处 见 大 。 

就 TDD[3] 话 题 展开 目前 仍 在 继续 的 “辩论 ?时 ， 鲍 勃 和 我 认识 到 ， 
我 们 均 同 意 软件 架构 在 开发 中 占据 重要 地 位 ， 但 束 其 确切 意义 而 言 ， 
我 们 之 间 还 有 分 上 收 。 然 而 ， 这 种 予 与 盾 康 利 的 讨论 相对 而 言 并 不 重 
要 ， 因 为 在 项 目 开 始 之 时 ， 我 们 理所当然 应 该 让 专业 人 士 投 入 些许 时 
间 去 思考 及 规划 。20 世 纪 90 年 代 末 期 有 关 仅 以 测试 和 代码 红 动 设计 的 
概念 已 一 去 不 返 。 相 对 于 任何 宏伟 愿景 ， 对 细节 的 关注 其 至 是 更 为 天 
键 的 专业 性 基础 。 首 先 ， 开 发 者 通过 小 型 实践 获得 可 用 于 大 型 实践 的 
技能 和 信用 度 。 其 次 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 天 不 紧 的 门 、 
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架构 只 是 软件 开发 用 到 的 借 喻 之 一 ， 主 要 用 在 那 种 等 同 于 建筑 师 
交付 毛坯 房 一 般 交付 初始 软件 产品 的 场合 。 ° 在 Scrum 和 敏捷 (Agile) 
的 日 子 里 ， 人 们 关注 的 是 快速 将 产品 推 癌 市 场 。 我 们 要 求 工厂 全 速 运 
转 、 生 产 软件 。 这 就 是 人 类 工厂 : 懂 思 考 、 会 感受 的 编码 人 ， 他 们 由 
产品 备 环 或 用 户 故 事 开 始 创造 产品 。 来 目 制造 业 的 借 喻 在 这 种 场合 大 
行 其 道 。 例 如 ，Scrum 束 从 装配 线 式 的 日 本 汽车 生产 方式 中 获 益 民 
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即便 是 在 汽车 工业 里 ， 大 量 工 作 也 并 不 在 于 生产 而 在 于 维护 一 一 
或 避免 维护 。 对 于 软件 而 言 ， 百 分 之 八 十 或 更 多 的 工作 量 集 中 在 我 们 
美 其 名 日 “维护 ”的 事情 上 : 其 实 束 是 修 修补 补 。 与 其 接受 西方 天 于 制 
造 好 软件 的 传统 看 法 ， 不 如 将 其 看 作 建 筑 工 业 中 的 房屋 修理 工 ， 或 者 
汽车 领域 的 汽 修 工 。 日 本 式 管理 对 于 这 种 事 怎 么 说 的 呢 ? 

大 约 在 1951 年 ， 一 种 名 为 “全 员 生 产 维护 ”(Total Productive 
Maintenance, TPM) 的 质量 你 证 手段 在 日 本 出 现 。 它 关注 维护 其 于 关 
注 生 产 。TPM 的 主要 文 柱 之 一 是 所 谓 的 5S 原 则 体系 。5S 是 一 父 规 程 ， 
用 “规程 ”这 个 词 ， 是 为 了 读者 便于 理解 。5S 原 则 其 实 是 精益 (Lean) 
一 一 西方 视野 中 的 一 个 时 晓 词 ， 也 是 在 软件 领域 潮 领 风骚 的 时 绪 词 
MEAN o EWKA (Uncle Bob) 在 前 言 中 写 到 的 ， 良 好 
的 软件 实践 遵循 这 些 规程 : 专注 、 镇 定 和 思考 。 这 并 非 总 只 有 关 实 
作 ， 有 关 推 动工 厂 设 备 以 最 高 速度 运转 。5S$ 哲 学 包括 以 下 概念 : 

整理 (Seiri) [4]， 或 谓 组 织 ( 想 想 英语 中 的 sort (分 类 、 排 序 ) 
一 词 ) 。 搞 清楚 事物 之 所 在 一 一 通过 恰当 地 命名 之 类 的 手段 一 一 至 关 
重要 。 觉 得 命名 标识 无 关 紧 要 ? SANS HE o 

整顿 (Sein) ， 或 谓 整 齐 ( 想 想 英文 中 的 systematize (系统 化 ) 
ll) 。 有 和 句 美国 老话 说 : 物 绰 有 其 位 ， 而 后 物 尽 归 其 位 (A place for 


everything, and everything in its place) 。 每 段 代码 都 该 在 你 希望 它 所 在 
的 地 方 一 一 如 采 不 在 那里 ， 就 需要 重 构 了 。 

清楚 (Seiso) ， 或 谓 清洁 ( 想 想 英文 中 的 shine (FER) 一 词 ) o 
清理 工作 地 的 拉线 、 油 污 和 边 角 废料 。 对 于 那 种 四 处 遗弃 的 市 注释 的 
代码 及 反映 过 往 或 期 望 的 无 注释 代码 ， 本 书 作 者 怎么 说 的 来 着 ? RZ 
而 后 快 。 

清洁 (Seiketsu) ， 或 谓 标 准 化 。 有 关 如 何 保持 工作 地 清洁 的 组 内 
共识 。 本 书 有 没有 提 到 在 开发 组 内 使 用 一 贯 的 代码 风格 和 实践 手段 ? 
这 些 标准 从 哪里 来 ? 读 读 看 。 

HSE (Shitsuke) [5]， 或 谓 纪 律 (Af) 。 在 实践 中 贯彻 规程 ， 
并 时 时 体现 于 个 人 工作 上 ， 而 且 要 乐于 改进 。 

如 果 你 接受 挑战 一 一 没 错 ， 束 是 挑战 ， 阅 读 并 应 用 本 书 ， 你 就 会 
理解 和 赞赏 上 述 最 后 一 条 。 我 们 最 终 是 在 驶 疝 一 种 负责 任 的 专业 精神 
之 根源 所 在 ， 这 种 专业 性 隶属 于 一 个 关注 产品 生命 周期 的 专业 领域 。 
在 我 们 遵循 TPM 来 维护 机 动车 和 其 他 机 械 时 ， 停 机 维护 一 一 等 待 缺 
陷 显 现 出 来 一 一 并 不 常见 。 我 们 更 上 一 层 楼 : BAMA, FE 
机 件 停止 工作 之 前 就 换 掉 它 ， 或 者 按 常 例 每 1000 基 里 (291609.3km) 
天 更 换 润 清油、 防止 请 损 和 开裂 。 对 于 代码 ， 应 无 情 地 做 重 构 。 还 可 
以 更 进一步 ， 残 像 TPM 运 动 在 50 多 年 前 的 创新 : 一 开始 惑 打造 更 易 维 
护 的 机 械 。 写 出 可 读 的 代码 ， 重 要 程度 不 亚 于 写 出 可 执行 的 代码 。 
1960 年 左右 ， 围 绕 TPM 引 入 的 终极 实践 (ultimate practice) ， 关 注 用 
全 新 机 械 奉 代 旧 机 械 。 诚 如 Fred Brooks 所 言 ， 我 们 或 许 应 该 每 7 年 就 重 
做 一 次 软件 的 主要 模块 ， 清 理 缓慢 陈腐 的 代码 。 也 许 我 们 该 把 重 构 周 
期 从 以 年 计 缩短 到 以 周 、 以 天 甚至 以 小 时 计 。 那 便 是 细 记 所 在 了 。 

细节 中 和 目 有 天 地 ， 而 在 生活 中 应 用 此 类 手段 时 也 有 微 言 大 义 ， 葡 
像 我们 一 成 不 变 地 对 那些 源 自 日 本 的 做 法 寄予 厚望 一 般 。 这 并 非 只 是 
东方 的 生活 观 ， 有 英美 民间 也 所 是 这 类 警句。 上 3 引 “ 整 顿 ”(Seiton) =F 


DE ESE RA ERU HTC] N, MESTRE GRIP 
ZR” ° “TERE” (Seiso) 又 如 何 呢 ? 整洁 近乎 虔诚 (Cleanliness is 
next to godliness) 。 一 张 脏 乱 的 桌子 足以 夺 去 一 所 丽 宅 的 光彩 。 老 话 
怎么 说 “ 刁 美 ” (Shitsuke) AY? SPAN XB (He who is faithful 
in little is faithful in much) 。 对 于 时 时 准备 在 恰当 时 机 做 重 构 ， 为 未 来 
的 “大 ”决定 夯实 基础 ， 而 不 是 置 诸 脑 后 ， 有 什么 说 法 吗 ? 及 时 一 针 省 
九 针 (A stitch in time saves nine) 。 早 起 的 鸟 儿 有 虫 吃 (The early bird 
catches the worm) » H 2H 4 (Don’t put off until tomorrow what you 
can do today) 。 在 精益 实践 落 入 软件 咨询 师 之 手 前 ， 这 就 是 其 所 谓 
“最 后 时 机 ”的 本 义 所 在 。 摆 正 单项 工作 在 整体 中 的 位 置 呢 ? BRET 
树 籽 (Mighty oaks from little acorns grow) 。 如 何在 日 常生 活 中 做 好 简 
单 的 防备 性 工作 呢 ? 防 病 好 过 治 病 (An ounce of prevention is worth a 
pound of cure) 。 一 天 一 人 苹果， 医生 远离 我 (An apple a day keeps the 
doctor away) ° REUEN HATIR, RE T REFERMI 
有 、 或 兽 有 、 或 该 有 的 壮丽 文化 之 下 的 智慧 根源 。 

即便 是 在 宏伟 的 建筑 作品 中 ， 我 们 也 听 到 关注 细 市 的 回 啊 。 
Ludwig mies van der Rohe 的 门 把 手 吧 。 那 正 是 整理 (sein) ° 
每 每 个 变量 名 。 你 当 用 为 自己 第 一 个 孩子 命名 般 的 瘟 慎 来 给 变 
名 o 

正如 每 位 房 主 所 知 ， 此 类 照 RC UE 建筑 师 
Christopher Alexander 模式 与 模式 语言 一 一 把 每 个 设计 动作 看 
作 是 较 小 的 局 部 修复 动作 。 他 认为 ， 设 计 a DL ANH 
ME, TO EA SEU ASUS Ea 25 E TUS ES RE RAL SEM © 
设计 始终 在 持续 进行 ， 不 只 是 在 新 建 一 个 房间 时 ， 也 在 我 们 重新 粉刷 
冰 面 、 更 换 旧 地 毯 或 者 换 厨 房 水 槽 时 。 大 多 数 艺 术 门 类 也 持 类 似 主 
张 。 在 寻找 其 他 推 染 细 市 的 人 时 ， 我 们 发 现 ，19 世 纪 法 国 作 家 Gustav 
Flaubert (HIERIE) 名 列 其 中 。 法 国 诗人 Paul Valery ( 保 尔 : 瓦 
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雷 里 ) 认为 ， 每 首 诗歌 都 无 写 完 之 时 ， 得 持续 重 写 ， 直 至 放弃 为 止 。 
全 心 倾注 于 细 矶 ， 屡 见于 退 求 卓越 的 行为 之 中 。 虽 然 这 无 其 狐 意 ， 但 
阅读 本 书 对 读者 仍 是 一 种 挑战 ， 你 要 重 拾 久 已 弃置 脑 后 的 民 好 规则 ， 
目 发 目 主 ,“ 员 应 改变 ”。 

不 洱 的 是 ， 我 们 往往 见 不 到 人 们 把 对 细 市 的 关注 当 作 编程 万 术 的 
基础 要 件 。 我 们 过 早 地 放弃 了 在 代码 上 的 工作 ， 并 不 是 因为 它 业 已 完 
成 ， 而 是 因为 我 们 的 价值 体系 关注 外 在 表现 其 于 关注 要 交付 之 物 的 本 
ie LA TREAT ER: 坏 东 西 一 再 出 现 。 无 论 是 在 行业 里 还 是 学 
术 领 域 ,， 人 研究 者 都 很 重视 代码 的 整洁 问题 。 供 职 于 贝尔 软件 生产 研究 
实验 室 (Bell Labs Software Production Research) 一 一 没 错 ， 就 是 生 
PI 一 一 时 ， 我 们 有 些 不 太 严 密 的 发 现 ， 认 为 前 后 一 致 的 缩 进 风 格 明 
显 标志 了 较 低 的 缺陷 率 。 我 们 原 指望 将 质量 归 因 于 架构 、 编 程 语 言 或 
者 其 他 高 级 概念 ， 我 们 的 专业 能 力 归 功 于 对 工具 的 掌握 和 各 种 高 高 在 
上 的 设计 方法 ， 至 于 那些 安置 于 厂区 的 机 右 ， 那 些 编码 者 ， 他 们 大 然 
通过 简单 地 保持 一 致 缩 进 风格 创造 了 价值 ， 这 人 简 直 是 一 种 侮辱 。 我 在 
17 年 前 就 在 书 中 写 过 ， 这 种 风格 远 不 止 是 一 种 单纯 的 能 力 那 么 简单 。 
日 本 式 的 世界 观 深 知 日 常 工作 者 的 人 价值， 而且， 还 深 知 工作 者 人 简单 的 
日 常 行为 所 锻造 的 开发 系统 的 价值 。 质 量 是 上 百 万 次 全 心 投入 的 结果 
一 一 而 非 仅 归功 于 任何 来 目 天 笔 的 伟大 方法 。 这 些 行 为 简单 却 不 簿 
陋 ， 也 不 意味 着 简易 。 相 反 ， 它 们 是 人 力 所 能 达 的 不 仅 伟大 而 且 美丽 
的 造物 。 忽 略 它们 ， 惑 不 成 其 为 完整 的 人 。 

当然 ， 我 仍然 提倡 放宽 思路 ， 也 推 尝 根植 于 深厚 领域 知识 和 软件 
可 用 性 的 各 种 架构 手法 的 价值 。 但 本 书 与 此 无 天 一 一 人 至 少 ， 没 有 明显 
天 系 。 本 书 精妙 之 处 ， 其 意义 之 深远 ， 不 该 无 人 赏识 。 它 正 与 Peter 
Sommerlad、Kevlin Henny 及 Giovanni Asproni 等 真正 写 代码 的 人 现今 所 
持 的 观念 相 吻 合 。 他 们 勤 吹 “代码 即 设计 ”和 “简单 代码 *”。 我 们 要 谭 
记 ， 界 面 就 是 程序 ， 而 且 其 结构 也 极 大 地 反映 出 程序 结构 ， 但 也 理应 


始终 谦逊 地 承认 设计 存在 于 代码 中 ， 这 人 至 关 紧 要 。 制 造 上 的 返工 导致 
成 本 上 升 ， 但 重 做 设计 却 创造 出 价值 。 我 们 应 当 视 代码 为 设计 作 
为 过 程 而 非 终点 的 设计 一 一 这 种 高 尚 行为 的 漂亮 体现 。 耦 合 与 内 聚 的 
染 构 韵律 在 代码 中 脉动 。Larry Constantine 以 代码 的 形式 而 不 是 用 
UML 那 种 高 高 在 上 的 抽象 概念 来 描述 耦合 与 内 聚 。Richard 
GarbrielfE*Abstraction Descant” (抽象 刍议 ) 一 文中 告诉 我 们 ， 抽 和 象 即 
恶 。 代 码 除 恶 ， 而 整洁 的 代码 则 大 抵 是 圣洁 的 。 
回 到 我 那个 小 小 的 乐 嚼 包 竣 盒 ， 我 想 要 重点 提 一 下， 那 句 丹 麦 诺 
语 不 只 是 教 我 们 重视 小 处 ， 更 教 我 们 小 处 要 诚实 。 这 意味 着 对 代码 诚 
实 、 对 同 你 坦承 代码 现状 ， 最 重要 的 是 在 代码 问题 上 不 目 欺 。 是 否 已 
尽 全 力 “ 把 露 谨 地 清理 得 比 来 时 还 干净 ”? 签 入 代码 前 是 否 已 做 重 构 ? 
这 可 不 是 皮毛 小 事 ， 它 正高 中 于 敏捷 价值 的 正中 位 置 。Scrum 有 一 种 
建议 的 实践 ， 主 张 重 构 是 “完成 ”(Done) 概念 的 一 部 分 。 无 论 是 架构 
还 是 代码 都 不 强求 完美 ， 只 求 痢 诚 尽力 而 已 。 人 就 无 过 ， 神 亦 容 之 
(To err is human: to forgive, divine) 。 在 Scrum 中 ， 我 们 使 一 切 可 见 。 
我 们 明 出 脏 衣 服 。 我 们 坦承 代码 状态 ， 因 为 它 永 不 完美 。 我 们 日 渐 成 
为 完整 的 人 ， 配 得 起 神 的 状 兢 ， 也 越 来 越 接 近 细节 中 的 伟大 之 处 。 
在 目 己 的 专业 领域 中 ， 我 们 亚 需 能 得 到 的 一 切 帮 助 。 假 使 干净 的 
地 板 能 减少 事故 发 生 ， 假 使 归 置 到 位 的 工具 能 提升 生产 力 ， 我 也 会 倾 
力 做 到 。 至 于 本 书 ， 在 我 看 过 的 有 关 将 精益 原则 应 用 于 软件 的 印刷 品 
中 ， 是 最 具 实 用 性 的 。 那 班 求索 者 多 年 来 并 屑 奋斗 ， 不 但 是 为 求 一 已 
之 进步 ， 更 将 他 们 的 知识 通过 和 你 手 上 正在 做 的 事 一 般 的 工作 贡献 给 
PTL: AAAS Ka Za, RAG, HARB ANS 
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[1]. 译 注 : 20 世 纪 中 期 著名 现代 建筑 大 师 ， RARE BUE YT 
哲学 ， 缔 造 了 玻璃 幕墙 等 现代 建筑 结构 。 


[2]. 译 注 : 本 书 主要 作者 Robert C. Martin? Uncle Bob, ix HAY “tz” 
及 后 文 的 “ 鲍 动 大 叔 * 束 是 指 Robert C. Martin ° 


[3]. 译 注 : Test Driven Development， 测 试 驱动 开发 。 

[4]. 译 注 : 这 些 概念 最 初出 现 于 日 本 ， 5 个 概念 的 日 文 罗 马 字 拼音 首 字 
母 正 好 都 是 $5， 所 以 这 里 也 保留 了 日 文 罗马 字 拼 音 写法 。 中 译本 以 日 
文 汉字 直接 译 出 ， 读 者 留意 ， 不 可 直接 对 应 其 中 文章 思 。 


[加 .译注 ， 中 文 意 为 素养 、 教 养 " 。 


关于 封面 


封面 的 图 片 是 M104: 草帽 星系 (The Sombrero Galaxy) ° M104 
坐落 于 处 女 座 (Virgo) ， 距 地 球 仅 3000 万 光 年 。 其 核心 是 一 个 质量 超 
大 的 黑洞 ， 有 100 万 个 太阳 那么 重 。 

这 幅 图 是 否 让 你 想起 了 Klingon 星 球 (FM) [1] 的 卫星 Praxis 

( 普 拉 西 斯 爆炸 的 事 ? 我 清楚 地 记得 ， 在 《 星 舰 迷航 VID F, A 

炸 之 后 雄 片 四 溅 ， 飞 幼 出 一 个 赤道 光环 的 场景 。 至 此 ， 光 环 就 成 为 科 
乡 电 影 中 爆炸 场景 的 必然 产物 了 。 甚 至 就 在 《 星 舰 迷航 》 系 列 电 影 的 
后 续 情 节 中 ，Alderaan (阿尔 德 然 ， 的 爆炸 也 有 类 似 场 景 出 现 。 

环绕 M104 的 光环 是 什么 造成 的 ? 它 为 何 会 有 如 此 巨大 的 膨胀 率 和 
如 此 明亮 而 微小 的 内 核 ? 在 我 看 来 ， 仿 佛 那 位 于 中 心 位 置 的 黑洞 用 然 
大 怒 ， 癌 星系 的 中 心 护 出 了 一 个 3 万 光 年 大 的 洞 一 般 。 在 这 场 宇 宙 大 月 
场所 及 范围 之 内 的 居民 全 都 大 难 临 凑 了 。 

超大 质量 的 黑洞 以 星体 为 食 ， 将 星体 的 相当 部 分 质量 转换 为 能 
量 。 方 程式 E = MC2 已 经 足够 体现 杠杆 作用 了 ， 但 当 MAMEA 
么 大 的 质量 时 ， 看 吧 ! 在 那 巨 兽 酒 足 饭 饱 之 前 ， 有 和 多少 星体 会 一 头 擅 
HEN SB? 核心 部 分 空洞 的 大 小 ， 是 否 说 明了 些 什 么 呢 ? 

封面 上 的 M104 图 片 ， 是 用 来 目 于 哈 邦 望远镜 的 那 幅 闭 名 的 可 见 区 
相片 (ERI) 和 Spitzer (斯 比 泽 ) 轨道 探测 器 最 新 的 红外 影像 (下 
图 ) 组 合 而 成 。 


TEZLEMRA A, SEERA ABUL AAS PET PUD BAK TR ^ XOU 
幅 影 像 组 合 起 来 ， 显 现 出 我 们 从 未 见 过 的 景象 ， 展 示 了 久远 之 前 曾 熊 
能 燃烧 的 火海 。 


HARR: 来 自 斯 比 泽 太空 望远镜 


系列 剧 《 星 舰 迷 航 》 (Star Trek) 中 的 故事 情 方 ，Praxis 星 爆炸 ， 
由 此 导致 联邦 和 Klingon 达 成 首次 和 平 协议 。 


ya E 


2007 年 3 月 ， 我 在 SD West 2007 技 术 大 会 上 聆听 了 Robert C. Martin 

(8E 2) A BL) 的 主题 演讲 “Craftsmanship and the Problem of 

Productivity: Secrets for Going Fast without Making a Mess" ° — E (KIA) 

ST PAN AAA, DA — HI] SE IR ZK AF 288334 Code Monkey RYE 
T) 开场 。 

是 的 ， 我 们 束 是 一 群 代 码 猴子 ， 上 蹄 下跌， 目 以 为 领略 了 编程 的 
真 诺 。 可 惜 ， 当 我 们 抓 着 几 个 酸 桃子 ， 得 意 洋 详 坐 到 树 校 上 ， 却 对 目 
己 造 成 的 混乱 熟视无睹 。 那 堆 “ 可 以 运行 ”的 配 矿 程序 ， 束 在 我 们 的 眼 
皮 压 下 慢 慢 腐 坏 。 

从 听 到 那 场 以 TDD 为 主题 的 演讲 之 后 ， 我 束 一 直 天 注 鲍 壹 大 朴 ， 
还 有 他 在 TDD 和 整洁 代码 方面 的 言论 。 去 年 ， 人 民 邮 电 出 版 社 计算 机 
分 社 拿 一 本 书 给 我 看 ， 封 面 上 赫然 写 着 Robert C. Martin 的 大 名 。 看 完 
原 书 序 和 前 言 ， 我 已 经 按 探 不 住 ， 接 下 了 翻译 此 书 的 任务 。 这 本 书 名 
为 Clean Code, J3 ÆObject Mentor (f@ 277 ALFF PAYER A E ia) FO VII 
公司 ) 一 干 大 牛 在 编程 方面 的 经 验 累 积 。 按 鲍 勃 大 权 的 话 来 说 ， 就 是 
“Object Mentor 整 洁 代 码 派 ” 的 说 明 © 

正如 Coplien 在 序 中 所 谨 ， 宏 大 建筑 中 最 细小 的 部 分 ， 比 如 天 不 
紧 的 门 、 有 点 儿 没 铺 平 的 地 板 ， 甚 至 是 凌乱 的 时 面 ， 都 会 将 整个 大 局 
的 魅力 虹 火 殖 尽 。 这 就 是 整洁 代码 之 所 系 。Coplien 列 举 了 许多 谚语 ， 
证 明 整 洁 的 价值 ， 中 国 也 有 修身 齐 家 治国 平 天 下 之 语 。 整 洁 代 码 的 重 
要 性 毋 良 置 疑 ， 问 题 是 如 何 写 出 真正 整洁 的 代码 。 
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函数 、 注 释 、 代 人 码 格式 、 对 象 和 数据 结构 、 错 误 处 理 、 边 界 问题 、 单 
元 测试 、 类 、 系 统 、 并 发 编程 等 方面 如 何 做 到 整洁 的 经 验 与 最 佳 实 
践 。 长 期 遵照 这 些 经 验 编写 代码 ， 所 谓 “ 代 码 感 ”也 残 目 然而 然 汶 生 出 
来 。 更 有 价值 的 部 分 是 鲍 有 副 大 权 本 人 对 3 个 Java 项 目的 剖析 与 改进 过 程 
的 实 操 记 录 。 通 过 这 多 达 3 章 的 重 构 记 录 ， 钱 有 邯 大 上 充分 地 证 明了 童子 
军 军 规 在 编程 领域 同样 适用 : 离开 时 要 比 发 现时 更 整洁 。 为 了 回 读 者 
呈现 代码 的 原始 状态 ， 这 部 分 代码 及 本 书 其 他 部 分 的 绝 大 多 数 代码 注 
释 都 不 做 翻译 。 如 果 读 者 有 任何 疑问 ， 可 通过 邮件 与 我 沟通 

(cleancode.cn@gmail.com) 。 

接触 开发 技术 十 多 年 以 来 ， 特 别 是 从 事 IT 技 术 媒 体 工作 六 年 以 
来 ， 我 见 过 许多 对 于 代码 整洁 性 缺乏 足够 重视 的 开发 者 。 不 算 过 分 地 
说 ， 这 是 职业 素养 与 基本 功 的 双重 缺陷 。 我 翻译 The Elements of C£ 
Style (中 译 版 《C# 编 程 风 格 》) 和 本 书 ， 实 在 也 是 希望 在 这 方面 看 到 
开发 者 重视 度 和 实际 应 用 的 提升 。 

在 本 书 的 结束 语 中 ， 鲍 动 大 卜 提 到 别人 给 他 的 一 条 脑 带 ， 上 面 的 
字样 是 Test Obsessed (沉迷 测试 ) è MARANA CATE Si 
带 。 不 仅 是 因为 胶带 很 紧 ， 而 且 那 也 是 条 精神 上 的 紧 入 叶 。....….. (Zr 
HER, DOBUICEIBEBBIVBSBDEM E TII. DRM BK 
了 模范 童子 军 。 我 想 ， 每 位 开发 者 都 需要 这 样 一 条 腕 市 吧 ? 


vb 
20094115 


e 
BILE 


The ONLY VACIc MAUrENeN 
|: WTFs MINUTE. 


OF Code QUALIT 
衡量 代码 质量 的 唯一 有 效 标 准 : WTF/min 


wTF 


DAd code. 


Good code. 
7&Thom Holwerda# fù, & http://www.osnews.com/story/19266/WTFs_m 
再 制 


你 的 代码 在 哪 道 门 后 面 ? 你 的 团队 或 公司 在 哪 道门 后 面 ? 为 什么 
会 在 那里 ? 只 是 一 次 普通 的 代码 复查 ， 还 是 产品 面世 后 才 发 现 一 连 串 
严重 问题 ? 我 们 是 否 在 战 战 殊 殊 地 调试 目 己 之 前 错 以 为 没 问 题 的 代 
码 ? 客户 是 否 在 流失 ? 经 理 们 是 否 把 我 们 有 盯 得 如 芒 刺 在 背 ? 当 事 态 变 
得 严重 起 来 ， 如 何 保证 我 们 在 那 道 正确 的 门 后 做 补救 工作 ? 答案 是 : 
技艺 (craftsmanship) 。 

习 忆 之 要 有 二 : 知 和 行 。 你 应 当 习 得 有 天 原则 、 模 式 和 实践 的 知 
识 ， 穷 尽 应 知之 事 ， 并 且 要 对 其 了 如 指 掌 ， 通 过 刻苦 实践 掌握 它 。 

我 可 以 教 你 蚤 目 行 车 的 物理 学 原理 。 实 际 上 ， 经 典 数 学 的 表达 方 
式 相对 而 言 确实 简洁 明了 。 重 力 、 摩 擦 力 、 角 动量 、 质 心 等 ， 用 一 页 
写 满 方程 式 的 纸 就 能 说 明日 。 有 了 这 些 方程 式 ， 我 可 以 为 你 证 明 出 骑 
车 完全 可 行 ， 而 且 还 可 以 告诉 你 骑 车 所 需 的 全 部 知识 。 即 便 如 此 ， 你 
ERAEN IR ES RITE o 

编码 亦 同 此 理 。 我 们 可 以 写 下 整洁 代码 的 所 有 “感觉 恨 好 ”的 原 
则 ， 放 手 让 你 去 干 (换言之 ， 让 你 从 自行 车 上 控 下 来 ) 。 那 样 的 话 ， 
我 们 算是 哪 门 子 老师 ? 而 你 又 会 成 为 怎样 的 学 生 呢 ? 

不 ! 本 书 可 不 会 这 么 做 。 

学 写 整 洁 代 码 很 难 。 它 可 不 止 于 要 求 你 掌握 原则 和 模式 。 你 得 在 
这 上 面 花 工夫 。 你 须 目 行 实 践 ， 且 体验 目 己 的 失败 。 你 须 观 察 他 人 的 
实践 与 失败 。 你 须 看 看 别人 是 怎样 蹦 中 学 步 ， 再 转 头 人 研究 他 们 的 路 
数 。 你 须 看 看 别人 是 如 何 绞 尽 脑 汗 做 出 决策 ， 又 是 如 何 为 错误 决策 付 
出 代价 。 

阅读 本 书 要 多 用 心思 。 这 可 不 是 那 种 降落 前 就 能 读 完 的 “感觉 不 
错 ” 的 飞机 书 。 本 书 要 让 你 用 功 ， 而 且 是 非常 用 功 。 如 何 用 功 ? 阅读 代 
码 一 一 大 量 代 码 。 而 且 你 要 去 琢磨 某 段 代码 好 在 什么 地 方 、 坏 在 什么 
地 方 。 在 我 们 分 解 ， 而 后 组 合 模 块 时 ， 你 得 亦 步 亦 趋 地 跟 上 。 这 得 花 
些 工 夫 ， 不 过 值得 一 试 。 


本 书 大 致 可 分 为 3 个 部 分 。 前 几 章 介绍 编写 整洁 代码 的 原则 、 模 式 
和 实践 。 这 部 分 有 相当 多 的 示例 代码 ， 读 起 来 颇具 挑战 性 。 读 完 这 几 
划 ， 束 为 阅读 第 2 部 分 做 好 了 准备 。 如 果 你 就 此 上 止步， 只 能 视 你 好 运 
W ! 

第 2 部 分 最 需要 花 工 夫 。 这 部 分 包括 几 个 复杂 性 不 断 增加 的 案例 研 
究 。 每 个 案例 都 清理 一 些 代码 一 一 把 有 问题 的 代码 转化 为 问题 少 一 些 
的 代码 。 这 部 分 极为 详细 。 你 的 思维 要 在 讲解 和 代码 段 之 间 跳 来 跳 
去 。 你 得 分 析 和 理解 那些 代码 ， 琢 磨 每 次 修改 的 来 龙 去 脉 。 

你 付出 的 劳动 将 在 第 3 部 分 得 到 回报 。 这 部 分 只 有 一 章 ， 列 出 从 上 
述 案 例 研 究 中 得 到 的 启示 和 灵感 。 在 遍 览 和 清理 案例 中 的 代码 时 ， 我 
们 把 每 个 操作 理由 记录 为 一 种 启示 或 灵感 。 我 们 尝试 去 理解 自己 对 阅 
读 和 修改 代码 的 反应 ， 尽 力 了 解 为 什么 会 有 这 样 的 感受 、 为 什么 会 如 
此 行事 。 结 果 得 到 了 一 套 描述 在 编写 、 了 阅读、 清理 代码 时 思维 方式 的 
知识 库 。 

如 果 你 在 阅读 第 2 部 分 的 案例 研究 时 没有 好 好 用 功 ， 那 么 这 套 知 识 
库 对 你 来 说 可 能 所 值 无 几 。 在 这 些 案例 研究 中 ， 每 次 修改 都 仔细 注 明 
了 相关 启示 的 标号 。 这 些 标号 用 方 括号 标 出 ， 如 : [H22]。 由 此 你 可 以 
看 到 这 些 启示 在 何 种 环境 下 被 应 用 和 编写 。 启 示 本 身 不 值钱 ， 启 示 和 与 
案例 研究 中 清理 代码 的 具体 决策 之 间 的 关系 才 有 价值 。 

如 有 果 你 跳 过 案例 研究 部 分 ， 只 阅读 了 第 1 部 分 和 第 3 部 分 ， 那 就 不 
过 是 又 看 了 一 本 关于 写 出 好 软件 的 “感觉 不 错 ? 的 书 。 但 如 果 你 肯 花 时 
间 琢 磨 那 些 案例 ， 亦 步 亦 趋 一 一 站 在 作者 的 角度 ， 人 迫使 自己 以 作者 的 
思维 路 径 考虑 问题 ， 就 能 更 深刻 地 理解 这 些 原则 、 模 式 、 实 践 和 启 
示 。 这 样 的 话 ， 就 像 一 个 熟练 地 掌握 了 骑 车 的 技术 后 ， 自 行车 就 如 同 
其 身体 的 延伸 部 分 那样 ， 对 你 来 说 ， 本 书 所 介绍 的 整洁 代码 的 原则 、 
模式 、 实 践 和 启示 就 成 为 了 本 身 具有 的 技艺 ， 而 不 再 是 “感觉 不 错 ” 的 
知识 。 
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阅读 本 书 有 两 种 原因 : 第 一 ， 你 是 个 程序 员 ， 第 二 ， 你 想 成 为 更 
好 的 程序 员 。 很 好 。 我 们 需要 更 好 的 程序 员 。 


这 是 本 有 关 编 写 好 程序 的 书 。 它 充 不 着 代码 。 我 们 要 从 各 个 方向 
来 考察 这 些 代 码 。 从 顶 癌 下 ， 从 确 往 上 ， 从 里 而 外 。 读 完 后 ， 束 能 知 
道 许多 关于 代码 的 事 了 。 而 且 ， 我 们 还 能 说 出 好 代码 和 糟 料 的 代码 之 
间 的 震 异 。 我 们 将 了 解 到 如 何 写 出 好 代码 。 我 们 也 会 知道 ， 如 何 将 糖 
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1.1 


有 人 也 许 会 以 为 ， 关 于 代码 的 书 有 点 儿 落 后 于 时 代 一 一 代码 不 再 
征 问题 ; 我 们 应 当 关 注 模型 和 需求 。 确 实 ， 有 人 说 过 我 们 正在 临近 代 
码 的 终结 点 。 很 快 ， 代 码 束 会 自动 产生 出 来 ， 不 需要 再 人 工 编 写 。 程 
序 员 完 全 没 用 了 ， 因 为 商务 人 士 可 以 从 规约 直接 生成 程序 。 

扯淡 ! 我 们 永远 掀 不 掉 代 码 ， 因 为 代码 呈现 了 需求 的 细 季 。 在 某 
些 层面 上 ， 这 些 细 市 无 法 被 忽略 或 抽象 ， 必 须 明确 之 。 将 需求 明确 到 
机 器 可 以 执行 的 细 市 程度 ， 就 是 编程 要 做 的 事 。 而 这 种 规约 正 是 代 
RB © 

我 期 望 语言 的 抽象 程度 继续 提升 。 我 也 期 望 领域 特定 语言 的 数量 
继续 增加 。 那 会 是 好 事 一 桩 。 但 那 终结 不 了 代码 。 实 际 上 ， 在 较 高 层 
次 上 用 领域 笃定 语言 撰写 的 规约 也 将 是 代码 ! 它 也 得 闫 谍 、 精 确 、 规 
范 和 详细 ， 好 让 机 器 理解 和 执行 。 

那 帮 以 为 代码 终 将 消失 的 伙计 ， 束 像 是 巴 望 看 发 现 一 种 无 规范 效 
学 的 数学 家 们 一 般 。 他 们 巴 望 着 ， 总 有 一 天 能 创造 出 某 种 机 器 ， 我 们 
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们 ， 只 有 这 样 ， 它 才能 把 含糊 不 清 的 需求 翻译 为 可 完美 执行 的 程序 ， 
精确 满足 需求 。 


这 种 事 永 远 不 会 发 生 。 即 便 症 人 类 ， 倾 其 全 部 的 直觉 和 创造 力 ， 
也 造 不 出 满足 客户 模糊 感觉 的 成 功 系统 来 。 如 有 果 说 需求 规约 原则 教 给 
了 我 们 什么 ， 那 就 古 归 置 民 好 的 需求 束 像 代码 一 样 正式 ， 也 能 作为 代 
码 的 可 执行 测试 来 使 用 。 

记 住 ， 代 码 确 然 古 我 们 最 终 用 来 表达 需求 的 那 种 语言 。 我 们 可 以 
创造 各 种 与 需求 接近 的 语言 。 我 们 可 以 创造 帮助 把 需求 解析 和 汇 整 为 
正式 结构 的 各 种 工具 。 然 而 ， 我 们 永远 无 法 抛弃 必要 的 精确 性 一 一 所 
以 代码 永存 。 


1.2 、 


最 近 我 在 读 Kent Beck# Implementation Patterns 〈 中 译 版 《实现 模 
X) [也 一 书 的 序言 。 他 这 样 写 道 : “..…. 本 书 基于 一 种 不 太 牢 靠 的 前 
fe: 好 代码 的 确 重要 .……” 这 前 提 不 牢靠 ? 我 反对 ! 我 认为 这 是 该 领域 
最 强 固 、 最 受 支 持 、 最 被 强调 的 前 提 了 (我 想 Kent 也 知道 ) 。 我 们 知 
道 好 代码 重要 ， 是 因为 其 短缺 实在 困扰 了 我 们 太 久 。 

20 世纪 80 年 代 末 ， 有 家 公司 写 了 个 很 流行 的 杀手 应 用 ， 许 多 专业 
人 士 都 买 来 用 。 然 后 ， 发 布 周 期 开始 拉 长 。 缺 陷 总 是 不 能 修复 。 装 载 
时 间 越 来 越久 ， 朋 普 的 几率 也 越 来 越 大 。 至 今 我 还 记得 日 己 在 某 天 池 
慌 地 关 掉 那个 程序 ， 从 此 再 不 用 它 。 在 那 之 后 不 久 ， 该 公司 束 关 门 大 
吉 了 。 


20 年 后 ， 我 见 到 那 家 公司 的 一 位 早期 雇员 ， 问 他 当年 发 生 了 什么 
事 。 他 的 回答 叫 我 剑 发 丽 惧 起 来 。 原 来 ， 当 时 他 们 赶 着 推出 产品 ， 代 
码 写 得 乱七八糟 。 特 性 越 加 越 多 ， 代 码 也 越 来 越 往 ， 最 后 再 也 没 法 管 
理 这 些 代码 了 。 是 糟 料 的 代码 毁 了 这 家 公司 。 

Wee BAT RAS TARTAR? 如 琳 你 是 位 有 点 儿 经 验 的 程 
序 员 ， 定 然 多 次 过 到 过 这 类 困境 。 我 们 有 专用 来 形容 这 事 的 词 ， 沼泽 
(wading) 。 我 们 趟 过 代码 的 水 域 。 我 们 穿 过 灌木 密布 、 瀑 布 暗 藏 的 
沼泽 地 。 我 们 拼命 想 找到 出 路 ， 期 望 有 点 什么 线索 能 局 发 我 们 到 奈 发 
生 了 什么 事 ; 但 目光 所 及 ， 只 十 越 来 越 多 死 气 沉沉 的 代码 。 
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是 想 快 点 完成 吗 ? 是 要 赶 时 间 吗 ? 有 可 能 。 或 许 你 觉得 自己 要 十 
好 所 需 的 时 间 不 够 ， 假 使 花 时 间 清 理 代 码 ， 老 板 就 会 大 发 雷霆 。 或 许 
你 只 是 不 耐烦 再 搞 这 套 程序 ， 期 望 早 点 结束 。 或 许 你 看 了 看 自己 承 详 
要 做 的 其 他 事 ， 意 识 到 得 赶紧 弄 完 手 上 的 东西 ， 好 接着 做 下 一 件 工 
作 。 这 种 事 我 们 都 干 过 。 

我 们 都 曾经 皮 一 眼目 己 亲 手 造 成 的 混乱 ， 决 定 弃 之 而 不 顾 ， 走 辐 
新 一 天 。 我 们 都 曾经 看 到 自己 的 烂 程序 居然 能 运行 ， 然 后 断言 能 运行 
的 烂 程序 总 比 什 么 都 没有 强 。 我 们 都 曾经 说 过 有 朝 一 日 再 回头 清理 。 
当然 ， 在 那些 日 子 里 ， 我 们 都 没 听 过 勒 布 朗 (LeBlanc) 法 则 : 稍 后 等 
于 永 不 (Later equals never) ° 


只 要 你 干 过 两 三 年 编程 ， 束 有 可 能 曾 被 菏 人 的 粳 糙 的 代码 绊 倒 
过 。 如 果 你 编程 不 止 两 三 年 ， 也 有 可 能 被 这 种 代码 拖 过 后 腿 。 进 度 延 
缓 的 程度 会 很 严重 。 有些 团 队 在 项 目 初期 进展 迅速 ， 但 有 那么 一 两 年 
的 时 间 却 慢 如 蜗 行 。 对 代码 的 每 次 修改 都 影响 到 其 他 两 三 处 代码 。 修 
改 无 小 事 。 每 次 添 加 或 修改 代码 ， 部 得 对 那 堆 扭 纹 柴 了 然 于 心 ， 这 样 
才能 往 上 扔 更 多 的 扭 纹 染 。 这 团 乱 廊 越 来 越 大 ， 表 也 无 法 理 清 ， 最 后 
RFR ° 

随 着 混乱 的 增加 ， 团 队 生 产 力也 持续 下 降 ， 赵 向 于 零 。 当 生产 力 
PMY, FERMARE AST: 增加 更 多 人 手 到 项 目 中 ， 期 望 
提升 生产 力 。 可 是 新 人 并 不 熟悉 系统 的 设计 。 他 们 搞 不 清楚 什么 样 的 
修改 符合 设计 意图 ， 什 么 样 的 修改 违背 设计 意图 。 而 且 ， 他 们 以 及 团 


队 中 的 其 他 人 都 背负 着 提升 生产 力 的 可 怕 压 力 。 于 是 ， 他 们 制造 更 多 
的 混乱 ， 驱 动 生产 力 同 零 那 闹 不 断 下 降 。 如 图 1-1 所 示 。 
100 
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生产 力 


时 间 
图 1-1 生产 力 vs. 时 间 


1.3.1 华丽 新 设计 


最 后 ， 开 发 团队 造反 了 ， 他 们 告诉 管理 屋 ， 表 也 无 法 在 这 令 人 生 
厌 的 代码 基础 上 做 开发 。 他 们 要 求 做 全 新 的 设计 。 管 理 层 不 愿意 投入 
资源 完全 重 局 炉灶 ， 但 他 们 也 不 能 否认 生产 力 低 得 可 怕 。 他 们 只 好 同 
意 开发 者 的 要 求 ， 授 权 去 做 一 套 看 上 去 很 美的 华丽 新 设计 。 

于 是 就 组 建 了 一 支 新 军 。 谁 都 想 加 入 这 个 团队 ， 因 为 它 是 张 白 
纸 。 他 们 可 以 重新 来 过 ， 搞 出 点 真正 漂亮 的 东西 来 。 但 只 有 最 优秀 、 
最 也 明 的 家 伙 补 选中。 其 余人 等 则 继续 维护 现 有 系统 。 

现在 有 两 支队 伍 在 竞赛 7。 新 团队 必须 搭建 一 套 新 系统 ， 要 能 实 
现 旧 系统 的 所 有 功能 。 男 外 ， 还 得 跟 上 对 旧 系 统 的 持续 改动 。 在 新 系 
统 功能 足以 抗衡 旧 系 统 之 前 ， 管 理 层 不 会 奉 换 挥 旧 系统 。 

吝 赛 可 能 会 持续 极 长 时 间 。 我 惑 见 过 延续 了 十 年 之 久 的 。 到 了 完 
成 的 时 候 ， 新 团队 的 老成 员 早已 不 知 去 同 ， 而 现 有 成 员 则 要 求 重 新 设 
计 一 套 新 系统 ， 因 为 这 套 系统 太 烂 了 。 


假使 你 经 历 过 哪怕 是 一 小 段 我 谈 到 的 这 种 事 ， 那 么 你 一 定 知道 ， 
花 时 间 保持 代码 整洁 不 但 有 关 效 率 ， 还 有 关 生 存 。 


1.3.2 & 


你 是 否 遇 到 过 某 种 严重 到 要 人 花 数 个 星期 来 做 本 来 只 需 数 小 时 即 可 
完成 的 事 的 混乱 状况 ? 你 是 否 见 过 本 来 只 需 做 一 行 修改 ， 结 果 却 涉及 
上 百 个 模块 的 情况 ? 这 种 事 太 常 见 了 。 

BARRERAE? E AREE Sk ZR Jot URS BS HJ TV 
码 ? 理由 多 得 很 。 我 们 抱怨 需求 变化 背离 了 初期 设计 。 我 们 月 叹 进度 
太 紧 张 ， 没 法 干 好 活 。 我 们 把 问题 归 答 于 那些 种 续 的 经 理 、 苛 求 的 用 
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(Dilbert) [2]， 我 们 是 自作 自 受 [3]。 我 们 太 不 专业 了 。 

这 话 可 不 太 中 听 。 怎 么 会 是 目 作 上 自 受 呢 ? 难道 不 关 需 求 的 事 ? 难 
道 不 关 进 度 的 事 ? 难道 不 关 那 些 蠢 经理 和 没 用 的 营销 手段 的 事 ?” 难道 
RAZR TI? 

不 。 经 理 和 和音 销 人 员 指 望 从 我 们 这 里 得 到 必须 的 信息 ， 然 后 才能 
做 出 承 诡 和 保证 ;即便 他 们 没 开口 同 ， 我 们 也 不 该 性 于 告知 目 己 的 想 
法 。 用 户 指望 我 们 验证 需求 是 否 都 在 系统 中 实现 了 。 项 目 经 理 指 望 我 
们 遵守 进度 。 我 们 与 项 目的 规划 脱 不 了 干系 ， 对 失败 负 有 极 大 的 下 
E; "En SAS ERA TES RESI 7579 REEL ! 
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经 理想 要 知道 实情 ， 即 便 他 们 看 起 来 不 喜欢 实情 。 多 数 经 理想 要 好 代 
码 ， 即 便 他 们 总 是 痴 凑 于 进度 。 他 们 会 奋力 卫 护 进 度 和 需求 ， 那 是 他 
们 该 干 的 。 你 则 当 以 同等 的 热情 卫 护 代码 。 

再 说 明日 上 毕 ， 假 使 你 是 位 医生 ， 病 人 人 请求 你 在 给 他 做 手术 前 别 尝 
手 ， 因 为 那 会 化 太 多 时 间 ， 你 会 照办 吗 [4]? 本 该 是 病人 说 了 算 ; 但 医 


生 却 绝对 应 该 拒绝 遵从 。 为 什么 ? 因为 医生 比 病 人 更 了 解 疾 病 和 感染 
的 风险 。 医 生 如 果 按 病人 说 的 办 ， 就 是 一 种 不 专业 的 态度 〈 更 别 说 是 
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同 理 ， 程 序 员 遵 从 不 了 解 混 乱 风 险 的 经 理 的 意愿 ， 也 是 不 专业 的 
做 法 。 


1.3.3 迷 题 


程序 员 面 临 着 一 种 基础 价值 谜 题 。 有 那么 几 年 经 验 的 开发 者 都 知 
道 ， 之 前 的 混乱 拖 了 目 己 的 后 腿 。 但 开发 者 们 硝 负 期 限 的 压力 ， 只 好 
制造 混乱 。 简 言 之 ， 他 们 没 花 时 间 让 自己 做 得 更 快 ! 真正 的 专业 人 士 
明日 ， 这 道 这 题 的 第 二 部 分 说 错 了 。 制 造 混乱 无 助 于 赶 上 期 限 。 温 乱 
只 会 立刻 拖 慢 你 ， 叫 你 错过 期 限 。 赶 上 期 限 的 唯一 方法 一 一 做 得 快 的 
唯一 方法 一 一 就 是 始终 尽 可 能 保持 代码 整洁 。 


1.3.4 整洁 代码 的 艺术 


假设 你 相信 混乱 的 代码 是 祸首 ， 假 设 你 接受 做 得 快 的 唯一 方法 是 
保持 代码 整洁 的 说 法 ， 你 一 定 会 自问 :“ 我 怎么 才能 写 出 整洁 的 代 
码 ? ”不 过 ， 如 果 你 不 明白 整洁 对 代码 有 何 意义 ， 尝 试 去 写 整 洁 代 码 就 
ZIA! 

坏 消息 是 写 整洁 代码 很 像 是 绘画 。 多 数 人 都 知道 一 幅 画 是 好 还 是 
坏 。 但 能 分 辨 优 劣 并 不 表示 懂得 绘画 。 能 分 辩 整 河 代 码 和 脐 脏 代码 ， 
也 不 意味 着 会 写 整洁 代码 ! 

写 整 洁 代 码 ， 需 要 遵循 大 量 的 小 技巧 ， 贯 彻 刻 音 习 得 的 “整洁 
感 ”。 这 种 “代码 感 ” 就 是 关键 所 在 。 有些 人 生 而 有 之 。 有 些 人 费 点 劲 才 
HEE 0 ECADULEMN ESIGN RA, BPR ALA 
为 优 的 攻略 。 
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缺乏 “代码 感 ” 的 程序 员 ， 看 混乱 是 混乱 ， 无 处 着 手 。 有 “代码 感 ” 的 
程序 员 能 从 混乱 中 看 出 其 他 的 可 能 与 变化 。“ 代 码 感 "帮助 程序 员 选 出 
最 好 的 方案 ， 并 指导 程序 员 制 订 修 改行 动 计 划 ， 按 图 索 驻 。 

简 言 之 ， 编 写 整 洁 代 码 的 程序 员 束 像 是 乞 术 家 ， 他 能 用 一 系列 变 
换 把 一 块 日 板 变 作 由 优雅 代码 构成 的 系统 。 


1.3.5 什么 是 整洁 代码 


有 多 少 程序 员 ， 就 有 多 少 定义 。 所 以 我 只 询问 了 一 些 非 常 知名 且 
经 难 丰 富 的 程序 员 。 

Bjarne Stroustrup , C++ 语言 发 明 者 ， C++Programming 
Language (〈 中 译 版 《C++ 程序 设计 语言 》) 一 书 作者 。 

我 喜欢 优雅 和 高 效 的 代码 。 代 码 逻 辑 应 当 直 和 截 了 当 ， 叫 缺陷 难以 
隐藏 尽量 减少 依赖 天 系 ， 使 之 便于 维护 ;依据 某 种 分 层 战 略 完善 错 
误 处 理 代码 ， 性 能 调 至 最 优 ， 省 得 引诱 别人 做 没 规矩 的 优化 ， 搞 出 一 
堆 混 乱 来 。 人 整洁 的 代码 只 做 好 一 件 事 。 

Bjame 用 了 “优雅 ”一 词 。 说 得 好 ! 我 MacBook 上 的 词典 提供 了 如 下 
EX: 外 表 或 举止 上 令 人 愉悦 的 优美 和 雅 观 ;， 令 人 愉悦 的 精致 和 简 
单 。 注 意 对 “愉悦 ”一 词 的 强调 。Bjarne 显 然 认 为 整洁 的 代码 读 起 来 令 人 
愉悦 。 读 这 种 代码 ， 就 像 见 到 手工 精美 的 音乐 盒 或 者 设计 精良 的 汽车 


一 般 ， 让 你 会 心 一 笑 。 


Bjarne 也 提 到 效率 一 一 而 且 两 次 提 及 。 这 话 出 目 C++ 发 明 者 之 
口 ， 或 许 并 不 出 奇 ， 不 过 我 认为 并 非 是 在 单纯 追求 速度 。 被 浪费 挥 的 
运算 周期 并 不 雅 观 ， 并 不 令 人 和 愉悦。 留意 Bjarme 怎么 描述 那 种 不 雅 观 
WIZE AR 0 HA “Slik a] o RT Sc PEARANCE S ABL! 别 
人 修改 粳 糕 的 代码 时 ， 往 往 会 越 改 越 仁 。 

务实 的 Dave Thomas 和 Andy Hunt 从 男 一 角度 阐述 了 这 种 情况 。 他 
们 提 到 破 窗 理论 [5]。 窗 户 破 损 了 的 建筑 让 人 觉得 似乎 无 人 照管 。 于 是 
别人 也 再 不 关心 。 他 们 放任 窗户 继续 破损 。 最 终 自 己 也 参加 破坏 活 
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敷衍 了 事 的 错误 处 理 代 码 只 是 程序 员 忽视 细节 的 一 种 表现 。 此 外 还 有 
内 存 泄 漏 ， 还 有 竞 态 条 件 人 代码。 还 有 前 后 不 一 致 的 命名 方式 。 结 末了 束 
是 凸现 出 整洁 代码 对 细节 的 重视 。 

Bjarne 以 “整洁 的 代码 只 做 好 一 件 事 ”结束 论断 。 毋 庸 置 疑 ， 软 件 设 
计 的 许多 原则 最 终 都 会 归结 为 这 人 句 警 语 。 有 那么 多 人 发 表 过 类 似 的 宫 
论 。 糟 糕 的 代码 想 做 太 多 事 ， 它 意图 混乱 、 目 的 含混 。 整 洁 的 代码 力 
求 集中 。 每 个 函数 、 每 个 类 和 每 个 模块 都 全 神 员 注 于 一 事 ， 完 全 不 受 
四 周 细 世 的 干扰 和 污染 。 

Grady Booch , Object Oriented Analysis and Design with 
Applications (中 译 版 《面向 对 象 分 析 与 设计 》) 一 书 作 者 。 

整洁 的 代码 简单 直接 。 整 洁 的 代码 如 同 优美 的 散文 。 整 洁 的 代码 
从 不 隐藏 设计 者 的 意图 ， 充 满 了 干净 利落 的 抽象 和 直截了当 的 控制 语 
AJ o 


Grady 的 观点 与 Bjarne 的 观点 有 类 似 之 处 ， 但 他 从 可 读 性 的 角度 来 
定义 。 我 特别 喜欢 “整洁 的 代码 如 同 优美 的 散文 ”这 种 看 法 。 想 想 你 读 
过 的 某 本 好 书 。 回 忆 一 下 ， 那 些 文字 是 如 何在 脑 中 形成 影像 ! Re 
看 了 场 电影 ， 对 吧 ? 还 不 止 ! 你 还 看 到 那些 人 物 ， 听 到 那些 声音 ， 体 
WAIRERE RER 

阅读 整洁 的 代码 和 阅读 Lord of the Rings 《中 译 版 《指环 王 》) A 
然 不 同 。 不 过 ， 仍 有 可 类 比 之 处 。 如 同一 本 好 的 小 说 般 ， 整 洁 的 代码 
应 当 明 确 地 展现 出 要 解决 问题 的 张力 。 它 应 当 将 这 种 张力 推 至 高 漳 ， 


以 某 种 显而易见 的 方案 解决 问题 和 张力 ， 使 读者 发 出 * 啊 哈 ! 本 当 如 
此 ! ”的 感叹 。 

窃 以 为 Grady 所 谓 “ 干 净利 落 的 抽象 ” (crisp abstraction) ， 力 是 绝 
妙 的 矛盾 修辞 法 。 毕 竟 crisp 几 乎 就 是 “具体 ”(concrete) 的 同义词 。 我 
MacBook 上 的 词典 这 样 定义 crisp 一 词 : RIMARRA, MSCs, KAT 
豫 或 不 必要 的 细 和 。 尽 管 有 两 种 不 同 的 定义 ， 该 词 还 是 承载 了 有 力 的 
言 息 。 代 码 应 当 讲 述 事实 ， 不 引 人 猜 测 。 它 只 该 包含 必需 之 物 。 读 者 
应 当 感 受到 我 们 的 果断 决绝 © 

“老大 ”Dave Thomas，OTI 公 司 创始 人 ，Eclipse 战 略 教父 

整洁 的 代码 应 可 由 作者 之 外 的 开发 者 阅读 和 增补 。 它 应 当 有 单元 
测试 和 验收 测试 。 它 使 用 有 意义 的 命名 。 它 只 提供 一 种 而 非 多 种 做 一 
件 事 的 途径 。 它 只 有 尽量 少 的 依赖 关系 ， 而 且 要 明确 地 定义 和 提供 清 
晰 、 尽 量 少 的 API。 代 码 应 通过 其 字面 表达 含义 ， 因 为 不 同 的 语言 导致 
并 非 所 有 必需 信息 均 可 通过 代码 自身 清晰 表达 。 


Dave 老 大 在 可 读 性 上 和 Grady 持 相同 观点 ， 但 有 一 个 重要 的 不 同 之 
处 。Dave 断 言 ， 整 洁 的 代码 便于 其 他 人 加 以 增补 。 这 看 似 显 而 易 见 ， 
但 亦 不 可 过 分 强调 。 毕 竟 易 读 的 代码 和 易 修改 的 代码 之 间 还 是 有 区 别 
的 。 

Dave 将 整洁 系 于 测试 之 上 ! 要 在 十 年 之 前 ， 这 会 让 人 大 跌眼镜 。 
但 测试 驱动 开发 (Test Driven Development) 已 在 行业 中 造成 了 深远 影 
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它 有 多 优雅 ， 不 管 有 多 可 读 、 多 易 理解 ， 微 乎 测试 ， 其 不 洛 亦 可 知 
也 o 

Dave 两 次 提 及 “尽量 少 ”。 显 然 ， 他 推 时 小 块 的 代码 。 实 际 上 ， 从 
有 软件 起 人 们 惑 在 反复 强调 这 一 点 。 越 小 越 好 。 

Dave 也 提 到 ， 代 码 应 在 字面 上 表达 其 舍 义 。 这 一 观点 源 目 Knuth 的 
“字面 编程 ” (literate programming) [6]。 结 论 就 是 应 当 用 人 类 可 读 的 方 
式 来 写 代码 。 

Michael Feathers, Working Effectively with Legacy Code (PE 
版 《修改 代码 的 艺术 》) 一 书 作者 。 

我 可 以 列 出 我 留意 到 的 整洁 代码 的 所 有 特点 ， 但 其 中 有 一 条 是 根 
本 性 的 。 整 洁 的 代码 总 是 看 起 来 像 是 某 位 特别 在 意 它 的 人 写 的 。 几 乎 
没有 改进 的 余地 。 代 码 作者 什么 都 想到 了 ， 如 采 你 企图 改进 它 ， 总 会 
回 到 原点 ， 和 赞叹 某 人 留 给 你 的 代码 一 一 全 心 投入 的 某 人 留 下 的 代码 。 


一 言 以 项 之 : 在 意 。 这 就 古本 书 的 题 则 所在。 或 许 该 加 个 副 标 
题 ， 如 何在 意 代 码 。 

Michael 一 针 见 血 。 整 洁 代 码 就 是 作者 着 力 照料 的 代码 。 有 人 曾 花 
时 间 让 它 保 持 简单 有 序 。 他 们 适当 地 关注 到 了 细节 。 他 们 在 意 过 。 


Ron Jeffries, Extreme Programming Installed (中 译 版 《极限 编 

程 实施 》) 以 及 Extreme Programming Adventures in C£ (中 译 版 
《C# 极 限 编程 探险 》) 作者 。 

Ron 初 入 行 就 在 战略 空军 司令 部 (Strategic Air Command) 编写 
Fortran 程序 ， 此 后 几乎 在 每 种 机 器 上 编写 过 每 种 语言 的 代码 。 他 的 言 
论 值 得 咀嚼 > 

近年 来 ， 我 开始 研究 贝克 的 简单 代码 规则 ， 差 不 多 也 都 琢 麻 透 
了 。 简 单 代码 ， 依 其 重要 顺序 : 


能 通过 所 有 测试 ; 


没有 重复 代码 ; 

体现 系统 中 的 全 部 设计 理念 ; 

包括 尽量 少 的 实体 ， 比 如 类 、 方法、 函数 等 。 

在 以 上 诸 项 中 ， 我 最 在 意 代 码 重复 。 如 果 同 一 段 代 码 反 复出 现 ， 
号 表示 某 种 想法 未 在 代码 中 得 到 良好 的 体现 。 我 尽力 去 找 出 到 瓜 那 是 


什么 ， 然 后 再 尽力 更 清晰 地 表达 出 来 。 

在 我 看 来 ， 有 意义 的 命名 是 体现 表达 力 的 一 种 方式 ， 我 往往 会 修 
改 好 几 次 才 会 定 下 名 字 来 。 借 助 Eclipse 这 样 的 现代 编码 工具 ， 重 命名 
代价 极 低 ， 所 以 我 无 所 顾忌 。 然 而 ， 表 达 力 还 不 只 体现 在 命名 上 “。 我 
也 会 检查 对 象 或 方法 是 否 想 做 的 事 太 多 。 如 采 对 和 象 功能 太 多 ， 最 好 是 
切 分 为 两 个 或 多 个 对 象 。 如 果 方 法 功能 太 多 ， 我 总 是 使 用 抽取 手段 
(Extract Method) 重 构 之 ， 从 而 得 到 一 个 能 较为 清晰 地 说 明 自 喘 功能 
的 方法 ， 以 及 为 外 数 个 说 明 如 何 实现 这 些 功 能 的 方法 。 

消除 重复 和 提高 表达 力 让 我 在 整洁 代码 方面 获 益 民 多 ， 只 要 铭记 
这 两 点 ， 改 进 脏 代 码 时 整 会 大 有 不 同 。 不 过 ， 我 时 党 关注 的 故 一 规则 
PIAF I > 

这 么 多 年 下 来 ， 我 发 现 所 有 程序 都 由 极为 相似 的 元 素 构成 。 例 如 
“在 集合 中 碍 找 某 物 ”。 不 管 是 雇员 记录 数据 库 还 是 名 - 值 对 哈 希 表 ， 或 
者 菏 类 条 目的 数组 ， 我 们 都 会 发 现 目 己 想 要 从 集合 中 找到 某 一 特定 条 
目 。 一 旦 出 现 这 种 情况 ， 我 通常 会 把 实现 手段 封 狼 到 更 抽象 的 方法 或 
类 中 。 这 样 做 好 处 多 多 。 

可 以 匈 用 某 种 稍 单 的 手段 ， 比 如 哈 布 表 来 实现 这 一 功能 ， 由 于 对 
搜索 功能 的 引用 指向 了 我 那个 小 小 的 抽象 ， 束 能 随 需 应 变 ， 修 改 实现 
手段 。 这 样 束 既 能 快速 前 进 ， 又 能 为 未 来 的 修改 预 留 余 地 。 

男 外 ， 该 集合 抽象 常常 提醒 我 留意 “真正 ”在 发 生 的 事 ， 避 人 免 随意 
实现 集合 行为 ， 因 为 我 真正 需要 的 不 过 是 某 种 简单 的 查找 手段 。 

减少 重复 代码 ， 提 高 表达 力 ， 提 早 构 建 简单 抽象 。 这 就 古 我 写 整 
清 代 码 的 方法 。 

Ron 以 究 罕 数 段 文字 概括 了 本 书 的 全 部 内 容 。 不 要 重复 代码 ， 只 
做 一 件 事 ， 表 达 力 ， 小 规模 抽象 。 该 有 的 都 有 了 。 

Ward Cunningham，Wiki 发 明 者 ，eXtreme Programming (极限 
编程 ) 的 创始 人 之 一 ，Smalltalk 语 言 和 面向 对 象 的 思想 领袖 。 所 有 在 


意 代 码 者 的 教父 。 

如 有 果 每 个 例 程 都 让 你 感到 深 合 已 意 ， 那 束 是 整洁 代码 。 如 采 代 码 
让 编程 语言 看 起 来 像 是 专 为 解决 那个 问题 而 存在 ， 束 可 以 称 之 为 漂 腕 
的 代码 。 


这 种 说 法 很 Ward。 它 教 你 听 了 之 后 就 点 头 ， 然 后 继续 听 下 去 。 如 
此 在 理 ， 如 此 浅显 ， 绝 不 故 作 高 深 。 你 大 概 以 为 此 言 深 合 己 意 吧 。 再 


走 近 点 看 看 。 

“.……. 深 合 己 意 ”。 你 最 近 一 次 看 到 深 合 己 意 的 模块 是 什么 时 候 ? 
RE PARE EI EA ARIE AUS? 你 不 是 也 曾 择 扎 厦 想 
抓 住 些 从 整个 系统 中 散落 而 出 的 线索 ， 编 织 进 你 在 读 的 那个 模块 吗 ? 
你 最 近 一 次 读 到 某 段 代码 、 并 且 如 同 对 Ward 的 说 法 点 头 一 般 对 这 段 代 
BAR, Æ AR RAS T°? 

Ward 28 URS 29 EGER BREST ^. 你 无 需 化 太 多 力气 。 那 代码 
就 是 深 合 你 意 。 它 明确 、 简 单 、 有 力 。 每 个 模块 都 为 下 一 个 模块 做 好 
准备 。 每 个 模块 者 告诉 你 下 一 个 模块 会 是 怎样 的 。 整 洁 的 程序 好 到 你 
根本 不 会 注意 到 它 。 设 计 者 把 它 做 得 像 一 切 其 他 设计 般 简 单 。 

AB Ward 有 关 “ 美 ?的 说 法 又 如 何 呢 ? 我 们 都 曾 面临 语言 不 是 为 要 解 
决 的 问题 所 设计 的 困境 。 但 Ward 的 说 法 又 把 球 踢 回 我 们 这 边 。 他 说 ， 
漂亮 的 代码 让 编程 语言 像 是 专 为 解决 那个 问题 而 存在 ! 所 以 ， 让 语言 
变 得 简单 的 责任 就 在 我 们 身上 了 ! 当心 ， 语 言 是 冥 奖 不 化 的 ! 是 程序 


ELE 2E A 
质 计 语言 显得 简单 * 


1.4 思想 流派 


我 (HAAR) 又 是 怎么 想 的 呢 ? 在 我 眼中 整洁 代码 是 什么 样 
的 ? 本 书 将 以 详细 到 吓 死 人 的 程度 告诉 你 ， 我 和 我 的 同道 对 整洁 代码 
的 看 法 。 我 们 会 告诉 你 关于 整洁 变量 名 的 想法 ， 关 于 整洁 函 效 的 想 
法 ， 关 于 整洁 类 的 想法 ， 如 此 等 等 。 我 们 视 这 些 观点 为 当然 ， 且 不 为 
其 逆 耳 而 致歉 。 对 我 们 而 言 ， 在 职业 生涯 的 这 个 阶段 ， 这 些 观点 确 属 
当然 ， 也 是 我 们 整 涪 代 码 派 的 圭 塞 。 


武术 家 从 不 认同 所 谓 最 好 的 武术， 也 不 认同 所 谓 绝 招 。 武 术 大 师 

们 和 常 弟 创建 自己 的 流派 ， 聚 徒 而 授 。 因 此 我 们 才 看 到 格雷 西 家 族 在 巴 

西 开创 并 传授 的 格雷 西 柔 术 (Gracie Jiu Jisu) ， 看 到 奥 山 龙 峰 

(Okuyama Ryuho) 在 东京 开创 并 传授 的 八 光 流 柔 术 (Hakkoryu Jiu 

Jistu) ， 看 到 李小龙 (Bruce Lee) 在 美国 开创 并 传授 的 截 拳 道 (Jeet 
Kune Do) ° 


种子 们 沉浸 于 创始 人 的 授 业 。 他 们 全 心 师 从 某 位 师 传 ， 排 斥 其 他 
ME. BLANK, HAURRA- RE, JRE CHARS 
能 。 有 些 弟 子 最 终 百 炼 成 钢 ， 创 出 新 招 数 ， 开 宗 立 派 。 

任何 门派 痢 并 非 绝 对 正确 。 不 过 ， 吴 处 某 一 门派 时 ， 我 们 总 以 其 
所 传 之 技 为 善 。 归 根 结 底 ， 练 习 八 光 流 柔 术 或 堆 克 道 ， 目 有 其 善 法 ， 
但 这 并 不 能 否定 其 他 | ] 派 所 授 之 法 。 

可 以 把 本 书 看 作 是 对 象 导 师 (Object Mentor) [7] 整 洁 代 码 派 的 说 
明 。 里 面 要 传授 的 融 是 我 们 勤 操 已 乞 的 方法 。 如 果 你 遵从 这 些 教诲 ， 
你 就 会 如 我 们 一 般 乐 受 其 益 ， 你 将 学 会 如 何 编写 整洁 而 专业 的 代码 。 
但 无 论 如 何 也 别 错 以 为 我 们 是 “正确 的 ”。 其 他 门派 和 师 传 和 我 们 一 样 
专业 。 你 有 必要 也 同 他 们 学 习 。 

实际 上 ， 书 中 很 多 建议 都 存在 争议 。 或 许 你 并 不 完全 同意 这 些 建 
议 。 你 可 能 会 强烈 反对 其 中 一 些 建议 。 这 样 手 好 的 。 我 们 不 能 要 求 做 
最 终 权威 。 男 外 一 方面 ， 书 中 列 出 的 建议 ， 力 是 我 们 长 久 至 思 、 从 数 
十 年 的 从 业经 验 和 无 数 尝试 与 错误 中 得 来 。 无 论 你 同意 与 否 ， 如 果 你 
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1.5 我 们 是 


Javadoc 中 的 @author 字 段 告诉 我 们 目 己 是 什么 人 。 我 们 是 作者 。 作 
者 都 有 读者 。 实 际 上 ， 作 者 有 责任 与 读者 做 展 好 沟通 。 下 次 你 写 代 码 
的 时 候 ， 记 得 上 自己 是 作者 ， 要 为 评判 你 工作 的 读者 写 代 码 。 

你 或 许 会 问 : 代码 真正 “ 读 ” 的 成 分 有 多 少 呢 ? 难道 力量 主要 不 是 
HES” EB? 

你 是 否 玩 过 “编辑 器 回放 ”? 20 世 纪 80、90 年 代 ，Emac 之 类 编辑 器 
记录 每 次 击 键 动作 。 你 可 以 在 一 小 时 工作 之 后 ， 回 放 击 键 过 程 ， 束 像 


征 看 一 部 高 速 电影 。 我 这 么 做 过 ， 结 果 很 有 趣 。 

回放 过 程 显 示 ， 多 数 时 间 都 是 在 滚动 屏幕 、 浏 览 其 他 模块 ! 

fil itt APR o 

tr) P2521] ERA ERA. > 

他 停 下 来 考虑 可 以 做 什么 。 

哦 ， 他 滚动 到 模块 顶端 ， 检 查 变 量 初 始 化 。 

现在 他 回 到 修改 处 ， 开 始 键入 。 
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他 又 删除 了 ! 

他 键入 了 一 半 什 么 东西 ， 又 删除 挥 。 
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他 回 到 修改 处 ， 重 新 键入 刚才 删 掉 的 代码 。 

他 停 下 来 。 

他 再 一 次 删 挥 代码 ! 

他 打开 为 一 个 窗口 ， 人 查看 别 的 于 类 。 那 古 个 复 载 印 数 吗 ? 

你 该 明日 了 。 读 与 写 花费 时 间 的 比例 超过 10:1。 写 新 代码 时 ， 我 们 
一 直 在 读 旧 代码 。 

既然 比例 如 此 之 高 ， 我 们 就 想 让 读 的 过 程 变 得 轻松 ， 即 便 那 会 使 
得 编写 过 程 更 难 。 没 可 能 光 写 不 读 ， 所 以 使 之 易 读 实际 也 使 之 易 写 。 

这 事 概 无 例外 。 不 读 周边 代码 的 话 就 没 法 写 代 码 。 编 写 代码 的 难 
度 ， 取 决 于 读 周边 代码 的 难度 。 要 想 干 得 快 ， 要 想 早点 做 完 ， 要 想 轻 
松 写 代码 ， 先 让 代码 易 读 吧 。 


1.6 童子 军 军 规 


光 把 代码 写 好 可 不 够 。 必 须 时 时 保持 代码 整 汽 。 我 们 都 见 过 代码 
随时 间 流 逝 而 腐 坏 。 我 们 应 当 更 积极 地 阻止 腐 坏 的 发 生 。 

音 用 美国 鞋子 军 一 条 简单 的 军 规 ， 应 用 到 我 们 的 专业 领域 : 

让 营地 比 你 来 时 更 干净 。[8] 

如 果 每 次 签 入 时 ， 代 码 都 比 签 出 时 干净 ， 那 么 代码 就 不 会 腐 坏 。 
清理 并 不 一 定 要 伦 多 少 功 夫 ， 也 许 只 是 改 好 一 个 变量 名 ， 拆 分 一 个 有 
点 过 长 的 男 数 ， 消 除 一 点点 重复 代码 ， 清 理 一 个 舱 套 计 语 铝 。 

你 想 要 为 一 个 代码 随时 间 流 逝 而 越 变 越 好 的 项 目 工作 吗 ? 你 还 能 
相信 有 其 他 更 专业 的 做 法 吗 ? 难道 持续 改进 不 是 专业 性 的 内 在 组 成 部 


分 吗 ? 


从 许多 角度 看 ， 本 书 都 是 我 2002 年 写 那 本 Agile Software 
Development: Principles, Patterns, and Practices (中 译 版 《敏捷 软件 
FR: 原则 、 模 式 与 实践 》， 人 简称 PPP) 的 “前 传 >。PPP 关 注 面 向 对 象 
设计 的 原则 ， 以 及 专业 开发 者 采用 的 许多 实践 方法 。 假 如 你 没 读 过 
PPP， 你 会 发 现 它 像 这 本 书 的 延续 。 如 果 你 读 过 ， 会 发 现 那 本 书 的 主张 
在 代码 层面 于 本 书 中 国 啊 。 

在 本 书 中 ， 你 会 发 现 对 不 同 设计 原则 的 引用 ， 包 括 单 一 权 责 原则 

(Single Responsibility Principle, SRP) 、 开 放 闭 合 原则 (Open Closed 
Principle, OCP) 和 依赖 倒置 原则 (Dependency Inversion Principle , 
DIP) 等 。 


1.8 小 结 
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家 用 过 的 工具 、 技 术 和 思维 过 程 。 本 书 同样 也 不 担保 让 你 成 为 好 程序 
Da 


。 它 不 担保 能 给 你 "代码 感 ”。 它 所 能 做 的 ， 只 是 展示 好 程序 员 的 思 
维 过 程 ， 还 有 他 们 使 用 的 技巧 、 技 术 和 工具 。 

和 艺术 书 一 样 ， 本 书 也 充满 了 细节 。 代 码 会 很 多 。 你 会 看 到 好 代 
人 码 ， 也 会 看 到 糟 焙 的 代码 。 你 会 看 到 糟糕 的 代码 如 何 转化 为 好 代码 。 
你 会 看 到 局 发 、 规 条 和 技巧 的 列表 。 你 会 看 到 一 个 又 一 个 例子 。 但 最 
终结 果 取 决 于 你 目 己 。 

还 记得 那个 关于 小 提 生 家 在 去 表演 的 路 上 迷路 的 老 笑 话 吗 ? 他 在 
街角 拦住 一 位 长 者 ， 问 他 怎么 才能 去 卡耐基 音乐 厅 (Carnegie Hall) 
长 者 看 了 看 小 提 稚 家 ， 又 看 了 看 他 手中 的 蕉 ， 说 道 : "WOOL. fA 
子 ， 还 得 练 ! T 
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[3]. 译 注 : 原文 为 But the fault, dear Dilbert, is not in our stars, but in 
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台词 The fault, dear Brutus, is not in our stars, but in ourselves, that we are 


underlings. 若 我 们 受 人 所 制 ， 亲 爱 的 勃 鲁 托 斯 ， 那 错 也 在 我 们 号 上 ， 


不 能 怪罪 命运 。) 


[4]. 原 注 : 1847 年 Ignaz Semmelweis ( 伊 纳 北 : 塞 麦 尔 维 斯 ) 提出 医生 应 
洗手 的 建议 时 ， 遭 到 了 反对 ， 人 们 认为 医生 太 忙 ， 接 诊 时 无 最 洗手 。 


[5]. 原 注 : http://www.pragmaticprogrammer.com/booksellers/2004- 
12.html ° 


[6]. 原 注 : [Knuth92] ° 
[7]. 译 注 : 本 书 主要 作者 Robert C.Martin 开 办 的 技术 咨询 和 培训 公司 。 


[8]. 原 注 : 摘自 Robert Stephenson Smyth Baden-Powell (英国 人 ， 童 子 军 
创始 者 ) 对 童子 军 的 遗言 : “努力 ， 让 世界 比 你 来 时 干净 些 ...... " 


软件 中 随处 可 见 命 名 。 我 们 给 变量 、 函 数 、 参 数 、 类 和 封包 命 
名 。 我 们 给 源 代码 及 源 代码 所 在 目录 命名 。 我 们 给 jar 文 件 、war 文 件 和 
ear 文 件 命 名 。 我 们 命名 、 命 名 ,不断 合 名。 有 既然 有 这 么 多 命名 要 做 ， 
不 妨 做 好 它 。 下 文 列 出 了 取 个 好 名 字 的 儿 条 简单 规则 o 


2.2 名 副 其 实 


名 副 其 实说 起 来 价 单 。 我 们 想 要 强调 ， 这 事 很 挛 肃 。 选 个 好 名 字 
要 人 花 时 间 ， 但 省 下 来 的 时 间 比 花 掉 的 多 。 注 意 命 名 ， 而 且 一 旦 发 现 有 
更 好 的 名 称 ， 就 换 揉 旧 的 。 这 么 做 ， 读 你 代码 的 人 (包括 你 自己) 都 
IIT 
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你 ， 它 为 什么 会 存在 ， 它 做 什么 事 ， 应 该 怎么 用 。 如 有 果 名 称 需 要 注释 
来 补充 ， 那 束 不 算是 名 副 其 实 。 

int d; // 消逝 的 时 间 ， 以 日 计 

名 称 d 什 么 也 没 说 明 。 它 没有 引起 对 时 间 消 逝 的 感觉 ， 更 别 说 以 日 
计 了 。 我 们 应 该 选择 指明 了 计量 对 象 和 计量 单位 的 名 称 : 


int elapsedTimeInDays; 


int daysSinceCreation; 

int daysSinceModification; 

int fileAgeInDays; 

选择 体现 本 意 的 名 称 能 让 人 更 容易 理解 和 修改 代码 。 下 列 代码 的 
目的 何在 ? 

public List<int[j> getThem() { 


List<int[]> list1 = new ArrayList<int[]>(); 
for (int[] x : theList) 


if (x[0] == 4) 
list1.add(x); 
return list1; 

} 

为 什么 难以 说 明 上 列 代码 要 做 什么 事 ? 里 面 并 没有 复杂 的 表达 
式 。 空 格 和 缩 进 中 规 中 和 矩 。 只 用 到 三 个 变量 和 两 个 常量 。 其 至 没有 涉 
及 任何 其 他 类 或 多 态 方 法 ， 只 是 (或 者 看 起 来 是 ) 一 个 数组 的 列表 而 
已 。 

问题 不 在 于 代码 的 简洁 度 ， 而 是 在 于 代码 的 模糊 度 : 即 上 下 文 在 
代码 中 未 被 明确 体现 的 程度 。 上 列 代码 要 求 我 们 了 解 类 似 以 下 问题 的 


(1) theList 中 是 什么 类 型 的 东西 ? 
(2) theList 零 下 标 条 目的 意义 是 什么 ? 
(3) 值 4 的 意义 是 什么 ? 
(4) 我 怎么 使 用 返回 的 列表 ? 
问题 的 答案 没 体现 在 代码 段 中 ， 可 那 殉 是 它们 该 在 的 地 方 。 比 方 
说 ， 我 们 在 开发 一 种 扫雷 游戏 ， 我 们 发 现 ， 盘 面 是 名 为 theList 的 单元 格 
列表 ， 那 就 将 其 名 称 改 为 gameBoard ° 
盘面 上 每 个 单元 格 都 用 一 个 和 疹 单 数组 表示 。 我 们 还 发 现 ， 零 下 标 
条 目 是 一 种 状态 值 ， 而 该 种 状态 值 为 4 表示 “已 标记 ”。 只 要 改 为 有 意义 
的 名 称 ， 代 码 就 会 得 到 相当 程度 的 改进 : 
public List<int[]> getFlaggedCells() 1 
List<int[]> flaggedCells = new ArrayList<int[]>(); 


for (int[] cell : gameBoard) 
if (cell STATUS VALUE] == FLAGGED) 
flaggedCells.add(cell); 
return flaggedCells; 


j 
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还 可 以 更 进一步 ， 不 用 int 数组 表示 单元 格 ， 而 是 另 写 一 个 类 。 该 
类 包括 一 个 名 副 其 实 的 函数 〈 称 为 isFlagged) ， 从 而 掩盖 住 那 个 魔术 
数 [1]。 于 是 得 到 函数 的 新 版 本 : 
public List<Cell> getFlaggedCells() { 
List<Cell> flaggedCells = new ArrayList<Cell>(); 
for (Cell cell : gameBoard) 
if (cell.isFlagged()) 
flaggedCells.add(cell); 
return flaggedCells; 
} 
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名 称 的 力量 。 


2.3 避免 误导 


程序 员 必 须 避 免 留 下 掩藏 代码 本 意 的 错误 线索 。 应 当 避 人 免 使 用 与 
本 意 相 悖 的 词 。 例 如 ，hp、aix 和 sco 都 不 该 用 做 变量 名 ， 因 为 它们 都 是 
UNIX 平 台 或 类 UNIX 平 台 的 专 有 名 称 。 即 便 你 古 在 编写 三 角 计 算 程 
序 ，hp 看 起 来 是 个 不 错 的 缩写 [2]， 但 那 也 可 能 会 提供 错误 信息 。 

别 用 accountList 来 指称 一 组 账号 ， 除 非 它 真 鸭 是 List 类 型 。List 一 词 
对 程序 员 有 特殊 意义 。 如 果 包 纳 账 号 的 容器 并 非 真 是 个 List， 就 会 引起 
错误 的 判断 [3]。 所 以 ， 用 accountGroup 或 bunchOfAccounts， 甚 至 直接 
用 accounts 都 会 好 一 些 。 


提防 使 用 不 同 之 处 较 小 的 名 称 。 想 区 分 模块 中 某 处 的 
XYZControllerFor EfficientHandlingOfStrings 和 5 一 处 的 
XYZControllerForEfficientStorageOfStrings, 27642 JH IE? 这 两 个 
词 外 形 实在 太 相 似 了 。 

以 同样 的 方式 拼写 出 同样 的 概念 才 是 信息 。 拼 写 前 后 不 一 致 束 是 
误导 。 我 们 很 享受 现代 Java 编 程 环 境 的 目 动 代码 完成 特性 。 刍 入 某 个 名 
称 的 前 几 个 字母 ， 按 一 下 某 个 热 键 组 合 〈 如 果 有 的 话 ) ， 就 能 得 到 一 
列 该 名 称 的 可 能 形式 。 假 如 相似 的 名 称 依 字母 顺序 放 在 一 起 ， 且 差异 
很 明显 ， 那 就 会 相当 有 助 益 ， 因 为 程序 员 多 半 会 压根 不 看 你 的 详细 注 
释 ， 甚 至 不 看 该 类 的 方法 列表 就 直接 看 名 字 挑 一 个 对 象 。 

误导 性 名 称 真正 可 怕 的 例子 ， 是 用 小 写字 母 ] 和 大 写字 母 O 作 为 变 
量 名 ， 尤 其 是 在 组 合 使 用 的 时 候 。 当 然 ， 问 题 在 于 它们 看 起 来 完全 像 


int a =]; 
if (O == 1) 
a = 0]; 
else 
1= 01; 
读者 可 能 会 认为 这 纯 属 虚构 ， 但 我 们 确 曾 见 过 充斥 这 类 玩意 的 代 
人 码 。 有 一 次 ， 代 码 作者 建议 用 不 同 字 体 写 变量 名 ， 好 显得 更 清楚 些 ， 
不 过 这 种 方案 得 要 通过 口头 和 书面 传递 给 未 来 所 有 的 开发 者 才 行 。 后 
只 是 做 了 简单 的 重 命名 操作 ， 就 解决 了 问题 ， 而 且 也 没 搞 出 别 的 


来 ， 
Eo 


2.4 意义 的 区 


如 果 程 序 员 只 是 为 满足 编译 器 或 解释 器 的 需要 而 写 代码 ， 束 会 制 
造 麻 烦 。 例 如 ， 因 为 同一 作用 范围 内 两 样 不 同 的 东西 不 能 重 名 ， 你 可 
能 会 随手 改 掉 其 中 一 个 的 名 称 。 有 时 干脆 以 错误 的 拼写 充 数 ， 结 果 就 
苹 出 现在 更 正 拼写 错误 后 导致 编译 紫 出 错 的 情况 。[4] 

光 是 添加 数 子 系列 或 是 废话 远 远 不 够 ,即便 这 足以 让 编译 表 满 
意 。 如 采 名 称 必须 相 异 ， 那 其 意思 也 应 该 不 同 才 对 。 


以 数字 系列 命名 〈al、a2，.……. aN) 是 依 义 命名 的 对 立 面 。 这 样 
的 名 称 纯 属 误导 一 一 完全 没有 提供 正确 信息 ; 没有 提供 导向 作者 意图 
的 线索 。 试 看 : 

public static void copyChars(char a1[], char a2[]) 1 


for (int i = 0; i < al.length; i++) { 
a2[i] = al[i]; 
} 
} 
如 果 参 数 名 改 为 Source 和 destination， 这 个 函数 束 会 像样 许多 o 


废话 是 另 一 种 没 意 义 的 区 分 。 假 设 你 有 一 个 Product 类 。 如 果 还 有 
一 个 ProductInfo 或 ProductData 类 ， 那 它们 的 名 称 虽 然 不 同 ， 意 思 却 无 
区 别 。Info 和 Data 就 像 a、an 和 the 一 样 ， 是 意义 含混 的 废话 。 

注意 ， 只 要 体现 出 有 意义 的 区 分 ， 使 用 a 和 the 这 样 的 前 级 就 没 
销 。 例 如 ， 你 可 能 把 a 用 在 域内 变量 ， 而 把 the 用 于 函数 参数 [5]。 但 如 
果 你 已 经 有 一 个 名 为 zork 的 变量 ， 又 想 调 用 一 个 名 为 theZork 的 变量 ， 
MARR T ° 

废话 都 是 元 余 。Variable 一 词 永远 不 应 当 出 现在 变量 名 中 。Table 一 
词 永远 不 应 当 出 现在 表 名 中 。NameString 会 比 Name 好 吗 ? 难道 Name 会 
Fe NE RBA BC? 如 采 是 这 样 ， 束 触犯 了 关于 误导 的 规则 。 设 想 有 
个 名 为 Customer 的 类 ， 还 有 一 个 名 为 CustomerObject 的 类 。 区 别 何在 
WE? 哪 一 个 是 表示 客户 历史 文 付 情 况 的 最 佳 途径 ? 

有 个 应 用 反映 了 这 种 状况 。 为 当事者 讳 ， 我 们 改 了 一 下 ， 不 过 犯 
错 的 代码 的 确 就 是 这 个 样子 : 


getActiveAccount(); 


getActiveAccounts(); 

getActiveAccountInfo(); 

程序 员 怎 么 能 知道 该 调用 哪个 函数 呢 ? 

如 果 缺 少 明 确 约 定 ， 变 量 moneyAmount XL 5 money 没 区 别 ， 
customerInfo 与 customer 没 区 别 ，accountData 5j account 1 X. 5] , 
theMessage 也 与 message 没 区 别 。 要 区 分 名 称 ， 束 要 以 读者 能 鉴别 不 同 
之 处 的 方式 来 区 分 。 


2.5 读 得 出 来 的 名 称 


人 类 长 于 记忆 和 使 用 单词 。 大 脑 的 相当 一 部 分 瓯 是 用 来 容纳 和 处 
理 单词 的 。 单 词 能 读 得 出 来 。 人 类 进化 到 大 脑 中 有 那么 大 的 一 块 地 方 
HAZE, BAIA, SIERRA © 

IMRAMIEATA, BHOBJIHSLS GT BUE, DL. FÉ 
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(pee ess zee kyew) [7] 整 数 ， 看 见 没 ? ”这 不 是 小 事 ， 因 为 编程 本 就 是 
一 种 社会 活动 。 

有 家 公司 ， 程 序 里 面 写 了 个 genymdhms 〈 生 成 日 期 ， 年 、 月 、 
日 、 时 、 分 、 秒 ) ， 他 们 一 般 读 作 “gen why emm dee aich emm ess" 
[8]。 我 有 个 见 字 照 读 的 恶习 ， 于 是 开口 就 念 “gen-yah-mudda-hims”。 后 
来 好 些 设计 师 和 分 析 师 都 有 样 学 样 ， 听 起 来 傻 平 平 的 。 我 们 知道 典 
故 ， 所 以 会 觉得 很 搞笑 。 搞 笑 归 搞 笑 ， 实 际 是 在 强 忍 糟糕 的 命名 。 在 
给 新 开发 者 解释 变量 的 意义 时 ， 他 们 总 是 读 出 傻乎乎 的 自 造 词 ， 而 非 
恰当 的 秽语 词 。 比 较 

class DtaRcrd102 { 


private Date genymdhms; 


private Date modymdhms; 
private final String pszqint = "102"; 
Jas EI 

}; 

和 

class Customer 1 
private Date generationTimestamp; 
private Date modificationTimestamp;; 
private final String recordId = "102"; 
Puy 


现在 读 起 来 就 像 人 话 了 : “HE, Mikey, @@ixHicse! 生成 时 间 
&X (generation timestamp) [9] 被 设置 为 明天 了 ! 不 能 这 样 吧 ? ” 


2.0 H SHyAA TA 
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找 MAX_CLASSES_PFER_STUDENT 很 容易 ， 但 想 找 数 字 7 就 麻烦 
了 ， 它 可 能 是 某 些 文件 名 或 其 他 常量 定义 的 一 部 分 ， 出 现在 因 不 同意 
图 而 采用 的 各 种 表达 式 中 。 如 有 果 该 常量 是 个 长 数字 ， 又 被 人 错 改过 ， 
吏 会 逃 过 搜索 ， 从 而 造成 错误 。 

同样 ，e 也 不 是 个 便于 搜索 的 好 变量 名 。 它 是 英文 中 最 常用 的 字 
母 ， 在 每 个 程序 、 每 段 代 码 中 都 有 可 能 出 现 。 由 此 而 见 ， 长 名 称 胜 于 
短 名 称 ， 搜 得 到 的 名 称 胜 于 用 目 造 编码 代 写 吏 的 名 称 。 

筋 以 为 单字 母 名 称 仅 用 于 短 方 法 中 的 本 地 变量 。 名 称 长 短 应 与 其 
作用 域 大 小 相对 应 [IN5]。 大 变量 或 常量 可 能 在 代码 中 多 处 使 用 ， 则 应 
赋 其 以 便于 搜索 的 名 称 。 再 比较 

for (int j=0; j<34; j++) { 

s += (t[j]*4)/5; 

} 

和 

int realDaysPerIdealDay = 4; 

const int WORK DAYS PER, WEEK = 5; 

int sum = 0; 

for (int j=0; j < NUMBER OF TASKS; j++) { 

int realTaskDays = taskEstimate[j] * realDaysPerIdealDay; 


int realTaskWeeks = (realdays / WORK DAYS PER, WEEK); 
sum += realTaskWeeks; 
j 
注意 ， 上 面 代 码 中 的 sum 并 非特 别 有 用 的 名 称 ， 不 过 它 至 少 搜 得 
到 。 采 用 能 表达 意图 的 名 称 ， 狐 似 拉 长 了 函数 代码 ， 但 要 想 想 看 ， 
WORK_DAYS_PER_WEEK 要 比 数字 5 好 找 得 多 ， 而 列表 中 也 只 剩 下 了 
体现 作者 意图 的 名 称 。 


YY 


2.7 


编码 已 经 太 多 ， 无 谓 再 目 找 麻 烦 。 把 类 型 或 作用 域 编 进 名 称 里 
面 ， 徒 然 增 加 了 解码 的 负担 。 没 理由 要 求 每 位 新 人 都 在 弄 清 要 应 付 的 
代码 之 外 〈 那 算是 正常 的 ， 还 要 再 搞 慌 男 一 种 编码 “语言 ”"。 这 对 于 
解决 问题 而 言 ， 纯 属 多 余 的 负担 。 带 编码 的 名 称 通常 也 不 便 发 音 ， 容 
DTI ° 


2.7.1 匈 下 利 语 标记 法 


在 往昔 名 称 长 短 很 要 命 的 时 代 ， 我 们 豪 无 必要 地 破坏 了 不 编码 的 
ALE, WS RIEDE © Fortran 语言 要 求 首 字母 体现 出 类 型 ， 导 致 了 编 
码 的 产生 。BASIC 早期 版 本 只 允许 使 用 一 个 字母 再 加 上 一 位 数字 。 匈 
牙 利 语 标记 法 (Hungarian Notation, HN) {XF TIE! è 

在 Windows 的 C 语 言 API 的 时 代 ，HN 相 当 重 要 ， 那 时 所 有 名 称 要 人 么 
是 个 整数 句柄 ， 要 么 是 个 长 指针 或 者 void 指针 ， 要 不 然 就 是 string 的 几 
种 实现 (有 不 同 的 用 途 和 属性 ) 之 一 。 那 时 候 编 译 器 并 不 做 类 型 检 
查 ， 程 序 员 需要 匈牙利 语 标记 法 来 帮助 自己 记 住 类 型 。 


现代 编程 语言 具有 更 丰富 的 类 型 系统 ， 编 译 侣 也 记得 并 强制 使 用 
类 型 。 而 且 ， 和 人们 趋向 于 使 用 更 小 的 类 、 更 短 的 方法 ， 好 让 每 个 变量 
的 定义 都 在 视野 范围 之 内 。 

Java 程 序 员 不 需要 类 型 编码 。 对 象 是 强 类 型 的 ， 代 码 编 辑 环 境 已 经 
先进 到 在 编译 开始 前 就 侦 测 到 类 型 错误 的 程度 ! 所 以 ， 如 今 HN 和 其 他 
类 型 编码 形式 都 纯 属 多 余 。 它 们 增加 了 修改 变量 、 画 数 或 类 的 名 称 或 
类 型 的 难度 。 它 们 增加 了 阅读 代码 的 难度 。 它 们 制造 了 让 编码 系统 误 
导读 者 的 可 能 性 。 

PhoneNumber phoneString; 

IN 类 型 变化 时 ， 名 称 并 不 变化 ! 


2.7.2 成 员 前 组 


也 不 必用 mm_ 前 绥 来 标明 成 员 变 量 。 应 当 把 类 和 函数 做 得 足够 小 ， 
消除 对 成 员 前 级 的 需要 。 你 应 当 使 用 某 种 可 以 高 亮 或 用 颜色 标 出 成 员 
的 编辑 环境 。 

public class Part { 


private String m_dsc; // The textual description 
void setName(String name) { 


m dsc = name; 


public class Part { 
String description; 
void setDescription(String description) 1 


this.description = description; 


) 
} 
此 外 ， 和 人们 会 很 快 学 会 无 视 前 级 (或 后 缀 ) ， 只 看 到 名 称 中 有 意 
义 的 部 分 。 代 码 读 得 越 多 ， 眼 中 残 越 没 有 前 级。 最 终 ， 前 级 变 作 了 不 
入 法 眼 的 废料 ， 变 作 了 上 代码 的 标志 物 。 


2.7.3 接口 和 实现 


有 时 也 会 出 现 采 用 编码 的 特殊 情形 。 比 如 ， 你 在 做 一 个 创建 形状 
用 的 抽象 工厂 (Abstract Factory) 。 该 工厂 是 个 接口 ， 要 用 具体 类 来 实 
现 。 你 怎么 来 命名 工 片 和 具体 类 呢 ? IShapeFactory 和 ShapeFactory 吗 ? 
我 喜欢 不 加 修饰 的 接口 。 前 导 字 母 I 被 滥用 到 了 说 好 昕 点 是 干扰 ， 说 难 
听 点 根本 就 是 废话 的 程度 。 我 不 想 让 用 户 知 道 我 给 他 们 的 是 接口 。 我 
就 想 让 他 们 知道 那 是 个 ShapeFactory。 如 果 接 口 和 实现 必须 选 一 个 来 编 
码 的 话 ， 我 宁肯 选择 实现 。ShapeFactoryImp ， 其 至 是 丑陋 的 
CShapeFactory， 都 比 对 接口 名 称 编码 来 得 好 。 


2.8 避免 思维 映射 


不 应 当 让 读者 在 脑 中 把 你 的 名 称 翻 译 为 他 们 熟知 的 名 称 。 这 种 问 
题 经 常 出 现在 选择 是 使 用 问题 领域 术语 还 是 解决 方案 领域 术语 时 。 

单字 母 变 量 名 就 是 个 问题 。 在 作用 域 较 小 、 也 没有 名 称 冲 突 时 ， 
循环 计数 器 自然 有 可 能 被 命名 为 或 或 k 。 (但 千 万 别 用 字母 1! ) 这 是 
因为 传统 上 惯用 单字 母 名 称 做 循环 计数 器 。 然 而 ， 在 多 数 其 他 情况 
下 ， 单 字母 名 称 不 是 个 好 选择 ， 读 者 必须 在 脑 中 将 它 映 射 为 真实 概 
念 。 仅 仅 是 因为 有 了 a 和 b， 就 要 取 名 为 c， 实 在 并 非 像样 的 理由 。 


T£ FF DOBLE BB ee HA AS o RBA BY A SS Bk PS Hc Ha 
明 。 总 而 言 之 ， 假 使 你 记得 r 代 表 不 包含 主机 名 和 图 式 (scheme) 的 小 
写 子 母 版 rl 的 话 ， 那 你 真是 太 聪 明了 。 

聪明 程序 员 和 专业 程序 员 之 间 的 区 别 在 于 ， 专 业 程序 员 了 解 ， 明 
确 是 王道 。 专 业 程 序 员 善 用 其 能 ， 编 写 其 他 人 能 理解 的 代码 。 


2.9 类 和 名 


类 名 和 对 象 名 应 该 是 名 词 或 名 词 短 语 ， 如 Customer、WikiPage、 
Account 4l AddressParser ° $f f€ FH Manager ^ Processor ^ Data 3X InfoixX 
样 的 类 名 。 类 名 不 应 当 是 动词 。 


2.10 方法 名 


方法 名 应 当 是 动词 或 动词 短语 ， 如 postPayment 、deletePage 或 
save。 属 性 访问 右 、 修 改 闫 和 断言 应 该 根据 其 值 命 名 ， 并 依 Javabean 标 
准 [10] 加 上 get、set 和 is 前 级 。 


string name = employee.getName(); 


customer.setName(" mike"); 

if (paycheck.isPosted())... 

重 载 构造 器 时 ， 使 用 描述 了 参数 的 静态 工厂 方 法 名 。 例 如 ， 
Complex fulcrumPoint = Complex.FromRealNumber(23.0); 
通常 好 于 

Complex fulcrumPoint = new Complex(23.0); 


可 以 考虑 将 相应 的 构造 器 设置 为 private， 强 制 使 用 这 种 命名 手段 。 


2.11 别 扮 可 爱 


如 果 名 称 太 朗 宝 ， 那 就 只 有 同 作者 一 般 有 幽默 感 的 人 才能 记得 
住 ， 而 且 还 是 在 他 们 记得 那个 笑话 的 时 候 才 行 。 谁 会 知道 名 为 
HolyHandGrenade[11] 的 函数 是 用 来 做 什么 的 呢 ? ETE, KATIE 
俐 ， 不 过 DeleteItems[12] 或 许 是 更 好 的 名 称 。 宁 可 明确 ， 毋 为 好 玩 。 


扮 可 爱 的 做 法 在 代码 中 经 常 体现 为 使 用 俗话 或 但 语 。 例 如 ， 别 用 
whack( )[13] 来 表示 kill( )。 别 用 eatMyShorts( )[14] 这 类 与 文化 紧密 相关 
的 笑话 来 表示 abort( ) ° 

言 到 意 到 。 意 到 言 到 。 


2.12 每 个 概念 对 应 一 个 证 


给 每 个 抽象 概念 选 一 个 词 ， 并 且 一 以 贯 之 。 例 如 ， 使 用 fetch、 
retrieve 和 get 来 给 在 多 个 类 中 的 同 种 方法 命名 。 你 怎么 记得 住 哪个 类 中 
是 哪个 方法 呢 ? 很 悲哀 ， 你 总 得 记 住 编写 库 或 类 的 公司 、 机 构 或 个 
人 ， 才 能 想 得 起 来 用 的 是 哪个 术语 。 否 则 ， 束 得 耗费 大 把 时 间 浏 贤 
个 文件 头 及 前 面 的 代码 。 

Eclipse 和 IntelliJj 之 类 现代 编程 环境 提供 了 与 环境 相关 的 线索 ， 比 如 
某 个 对 象 能 调用 的 方法 列表 。 不 过 要 注意 ， 列 表 中 通常 不 会 给 出 你 为 
函数 名 和 参数 列表 编写 的 注释 。 如 采 参 数 名 称 来 目 函 数 声 明 ， 你 残 太 
苇 运 了 。 轴 数 名 称 应 当 独 一 无 二 ， 而 且 要 保持 一 致 ， 这 样 你 才能 不 借 
助 多 余 的 浏 贤 束 找到 正确 的 方法 。 

同样 ， 在 同一 堆 代 码 中 有 controller， 又 有 manager， 还 有 driver， 就 
会 令 人 困惑 。DeviceManager 和 Protocol-Controller 之 间 有 何 根本 区 别 ? 
为 什么 不 全 用 controllers 或 managers? 他 们 都 是 Drivers 吗 ? 这 种 名 称 ， 
让 人 觉得 这 两 个 对 象 是 不 同类 型 的 ， 也 分 属 不 同 的 类 。 

对 于 那些 会 用 到 你 代码 的 程序 员 ， 一 以 贯 之 的 命名 法 简直 就 是 天 


降 和 福音 。 


2.13 Fl 语 


避免 将 同一 单词 用 于 不 同 目的 。 同 一 术语 用 于 不 同 概念 ， 基 本 上 
束 是 双关 语 了 “。 如 采 遵 循 “ 一 词 一 义 ? 规 则 ， 可 能 在 好 多 个 类 里 面 都 会 
有 add 方 法 。 只 要 这 些 add 方 法 的 参数 列表 和 返回 值 在 语义 上 等 价 ， 整 
一 切 顺 利 。 

但 是 ， 可 能 会 有 人 雇 定 为 “保持 一 致 "而 使 用 add 这 个 词 来 命名 ， 即 
便 并 非 真 的 想 表 示 这 种 意思 。 比 如 ， 在 多 个 类 中 都 有 add 方 法 ， 该 方法 
通过 增加 或 连接 两 个 现存 值 来 获得 新 值 。 假 设 要 写 个 新 类 ， 该 类 中 有 


一 个 方法 ， 把 单个 参数 放 到 群集 (collection) 中 。 该 把 这 个 方法 叫做 
add 吗 ? 这 样 做 貌似 和 其 他 add 方法 保持 了 一 致 ， 但 实际 上 语义 却 不 
同 ， 应 该 用 insert 或 append 之 类 词 来 命名 才 对 。 把 该 方法 命名 为 add， 整 
ENKE J ° 

代码 作者 应 尽力 写 出 易于 理解 的 代码 。 我 们 想 把 代码 写 得 让 别人 
能 一 目 尽 唤 ， 而 不 必 婵 精 竟 虑 地 人 研究。 我 们 想 要 那 种 大 众 化 的 作者 尽 
责 写 清楚 的 平 效 书 模式 ， 我 们 不 想 要 那 种 学 者 控 地 三 尺 才 能 明日 个 中 
意义 的 学 院 派 模式 。 


v 


2.14 BY A^ PI 


记 住 ， 只 有 程序 员 才 会 读 你 的 代码 。 所 以 ， 尽 管用 那些 计算 机 科 
学 (Computer Science, CS) 术语 、 算 法 名 、 模 式 名 、 数 学 术语 吧 。 依 
据 问 题 所 涉 领 域 来 命名 可 不 算是 聪明 的 做 法 ， 因 为 不 该 让 协作 者 老 是 
跑 去 问 客户 每 个 名 称 的 含义 ， 其 实 他 们 早 该 通过 另 一 名 称 了 解 这 个 概 
I° 

XT + FAK ih] (VISITOR) 模式 的 程序 来 说 ， 名 称 
AccountVisitor 富有 意义 。 哪 个 程序 员 会 不 知道 JobQueue 的 意思 呢 ? 程 
序 员 要 做 太 多 技术 性 工作 。 给 这 些 事 取 个 技术 性 的 名 称 ， 通 常 是 最 靠 
谱 的 做 法 。 


如 果 不 能 用 程序 员 熟 悉 的 术语 来 给 手头 的 工作 命名 ， 就 采用 从 所 
涉 问题 领域 而 来 的 名 称 吧 。 至 少 ， 负 责 维护 代码 的 程序 员 就 能 去 请 教 


领域 专家 了 。 

优秀 的 程序 员 和 设计 师 ， 其 工作 之 一 就 是 分 离 解决 方案 领域 和 问 
题 领域 的 概念 。 与 所 涉 问题 领域 更 为 贴近 的 代码 ， 应 当 采 用 源 自问 是 
领域 的 名 称 。 


2.16 添加 有 意义 的 语 境 


很 少 有 名 称 是 能 自我 说 明 的 一 -多 数 都 不 能 。 反 之 ， 你 需要 用 有 
民 好 命名 的 类 、 函 数 或 名 称 空间 来 放置 名 称 ， 给 读者 提供 语 境 。 如 采 
没 这 么 做 ， 给 名 称 添加 前 级 就 是 最 后 一 招 了 。 

设想 你 有 名 为 firstName ` lastName ^ street ^ houseNumber ` city ^ 
state 和 zipcode 的 变量 。 当 它们 搓 一 块 儿 的 时 候 ， 很 明确 是 构成 了 一 个 
地 址 。 不 过 ， 假 使 只 是 在 某 个 方法 中 看 见 孤 零 零 一 个 state 变 量 呢 ? 你 会 
理所当然 推 炳 那 是 某 个 地 址 的 一 部 分 吗 ? 

可 以 添加 前 级 addrFirstrName、addrLastrName、addrState 等 ， 以 此 提 
供 语 境 。 人 至 少 ， 读 者 会 明白 这 些 变 量 是 某 个 更 大 结构 的 一 部 分 。 当 
然 ， 更 好 的 方案 是 创建 和 名 为 Address 的 类 。 这 样 ， 即 便 是 编译 右 也 会 知 
道 这 些 变量 隶属 某 个 更 大 的 概念 了 。 

看 看 代码 清单 2-1 中 的 方法 。 以 下 变量 是 否 需 要 更 有 意义 的 语 境 
UE? KAZAA E Sabai, SHIETeDE TP AaB oS © ale bt ERR 
后 ， 你 会 知道 number、verb 和 pluralModifier 这 三 个 变量 是 “ 测 估 ”信息 的 
一 部 分 。 不 笠 的 是 这 语 境 得 靠 读 者 推断 出 来 。 第 一 眼看 到 这 个 方法 
上 时， 这 些 变量 的 含义 完全 不 清楚 。 

代码 清单 2-1 语 境 不 明确 的 变量 


private void printGuessStatistics(char candidate, int count) 1 


String number; 


String verb; 

String pluralModifier; 

if (count == 0) { 
number = "no"; 
verb = "are"; 
pluralModifier = "s"; 

} else if (count == 1) i 
number = "1"; 


We wit, 


verb = "is 
m ="; 
} else { 
number = Integer.toString(count); 
verb = "are"; 
pluralModifier = "s"; 
} 
String guessMessage = String.format( 
"There %s %s %s%s", verb, number, candidate, pluralModifier 
); 
print(guessMessage); 
È 
上 列 函 数 有 点 儿 过 长 ， 变 量 的 使 用 贯穿 始终 。 要 分 解 这 个 函数 ， 
需要 创建 一 个 名 diat eia eh 把 三 个 变量 做 成 该 类 的 
字段 。 这 样 它 们 吏 在 变 作 了 GuessStatisticsMessage 的 一 部 
。 语 境 的 增强 也 让 算法 能 够 通过 分 解 为 更 小 的 函数 而 变 得 更 为 干净 
ais 。 (如 代码 清单 2-2 所 示 。 B 
代码 清单 2-2 有 语 境 的 变量 


public class GuessStatisticsMessage 1 


private String number; 
private String verb; 
private String pluralModifier; 
public String make(char candidate, int count) 1 
createPluralDependentMessageParts(count); 
return String.format( 
"There 96s 96s 96s96s", 
verb, number, candidate, pluralModifier ); 
} 
private void createPluralDependentMessageParts(int count) { 
if (count == 0) { 
thereAreNoLetters(); 
} else if (count == 1) { 
thereIsOneLetter(); 
} else 1 
thereAreManyLetters(count); 


} 
private void thereAreManyLetters(int count) { 
number = Integer.toString(count); 


verb = "are"; 


Uol. 


pluralModifier = "s"; 


} 
private void thereIsOneLetter() 1 


number = "1"; 


We wit, 


verb = "is"; 


n", 
, 


pluralModifier = 


} 
private void thereAreNoLetters() { 
number = "no"; 
verb = "are"; 
pluralModifier = "s"; 
} 
} 


2.17 N 7 N > M E 


设 和 若 有 一 个 名 为 "加油 站 豪华 版 ” (Gas Station Deluxe) 的 应 用 ， 在 
其 中 给 每 个 类 添加 GSD 前 绥 束 不 是 什么 好 点 了 于。 说 日 了 ， 你 是 在 和 目 
己 在 用 的 工具 过 不 去 。 输 入 G， 按 下 目 动 完成 键 ， 结 有 末 会 得 到 系统 中 全 
部 类 的 列表 ， 列 表 恨 不 得 有 一 英里 那么 长 。 这 样 做 聪明 吗 ? 为 什么 要 
搞 得 IDE 没 法 帮助 你 ? 

再 比如 ， 你 在 GSD 应 用 程序 中 的 记 账 模块 创建 了 一 个 表示 邮件 地 
址 的 类 ， 然 后 给 该 类 命名 为 GSDAccountAddress。 稍 后 ， 你 的 客户 联络 
应 用 中 需要 用 到 邮件 地 址 ， 你 会 用 GSDAccountAddress 吗 ? 这 名 字 听 起 
来 没 问 题 吗 ? 在 这 17 个 字母 里 面 ， 有 10 个 字母 纯 属 多 余 和 与 当前 语 境 
ICA ° 
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对 于 Address 类 的 实体 来 说 ，accountAddress 和 customerAddress 都 是 
不 错 的 名 称 ， 不 过 用 在 类 名 上 就 不 太 好 了 。Address 是 个 好 类 和 名。 如果 
需要 与 MAC 地 址 、 端 口 地 址 和 Web 地 址 相 区 别 ， 我 会 考虑 使 用 


PostalAddress、MAC 和 URI。 这 样 的 名 称 更 为 精确 ， 而 精确 正 是 命名 的 


2.18 最 后 的 话 


取 好 名 字 最 难 的 地 方 在 于 需要 民 好 的 描述 技巧 和 共有 文化 背景 。 
与 其 说 这 是 一 种 技术 、 商 业 或 管理 问题 ， 还 不 如 说 是 一 种 教学 问题 。 
其 结果 是 ， 这 个 领域 内 的 许多 人 都 没 能 学 会 做 得 很 好 。 

我 们 有 了 时 会 怕 其 他 开发 着 反对 重合 名。 如 琳 讨 论 一 下 束 知 道 ， 如 
果 名 称 改 得 更 好 ， 那 大 家 真 的 会 感激 你 。 多 数 时 候 我 们 并 不 记忆 类 和 名 
和 方法 名 。 我 们 使 用 现代 工具 对 付 这 些 细 入 ， 好 让 目 己 集中 精力 于 把 
代码 写 得 就 像 词句 篇 章 、 至 少 像 是 表 和 数据 结构 (词句 并 非 总 是 呈现 
数据 的 最 佳 手段 ) 。 改 名 可 能 会 让 某 人 吃惊 ， 就 像 你 做 到 其 他 代码 改 
善 工作 一 样 。 别 让 这 种 事 阻 碍 你 的 前 进步 做。 

不 妨 试 试 上 面 这 些 规则 ， 看 你 的 代码 可 读 性 是 人 否 有 所 提升 。 如 果 
你 是 在 维护 别人 写 的 代码 ， 使 用 重 构 工 具 来 解决 问题 。 效 果 立 竿 见 
影 ， 而 且 会 持续 下 去 。 


[1]: 即 表示 已 标记 的 4。 
[2]. 译 注 : 即 hypotenuse 的 缩写 。 


[3]. 原 注 : 如 后 文 提 到 的 ， 即 便 容 希 融 是 个 List， 最 好 也 别 在 名 称 中 写 
I Aare MU, © 


[4]. 原 注 : 例如 ， 束 因为 class 已 有 他 用 ， 束 给 一 个 变量 命名 为 klass， 这 
Ee n BS SCA ° 


[5]. 原 注 : MBAR TECH PIS, (IRB T. BAARDE 
使 这 种 做 法 变 得 没 必要 了 © 


[6]. 译 注 : BCR3CNT 的 读音 


o 


[7]. 译 注 : PSZQ 的 读音 ° 


[8]. 译 注 : YMDHMS 的 读音 


o 


[9]. 译 注 : 读 到 generation timestamph}, WARES f PAY 
generationTimestamp 变 量 对 应 上 。 


[10]. 原 注 : 
[11] ETE: 
[12]. 87: 
[13]. 8, 
[14]. 美 倡 ， 


http://java.sun.com/products/javabeans/docs/spec.html ° 
意 为 “删除 条 目 ”。 
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在 编程 的 早年 多 月， 系统 由 程序 和 子 程序 组 成 。 后 来 ， 在 Fortran 
和 PL/A 的 年 代 ， 系 统 由 程序 、 子 程序 和 函数 组 成 。 如 今 ， 只 有 函数 存 
活 下 来 。 男 数 是 所 有 程序 中 的 第 一 组 代码 。 本 章 将 讨论 如 何 写 好 函 
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THEBIS 3-1 fEFitNesse[1]FP , REREKAI, PIX, 
是 搜寻 到 一 个 。 它 不 光 长 ， 而 且 代 码 也 很 复杂 ， 有 大 量 字 符 串 、 怪 


而 不 显 见 的 数据 类 型 和 API。 花 3 分 钟 时 间 ， 看 能 读 懂 多 少 ? 
代码 清单 3-1 HtmlUtil.java (FitNesse 20070619) 
public static String testableHtml( 
PageData pageData, 
boolean includeSuiteSetup 
) throws Exception { 
WikiPage wikiPage = pageData.getWikiPage(); 
StringBuffer buffer = new StringBuffer(); 
if (pageData.hasAttribute("Test")) { 
if (includeSuiteSetup) { 
WikiPage suiteSetup = 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder. SUITE SETUP NAME, wikiPage 


); 
if (suiteSetup != null) { 
WikiPagePath pagePath = 


suiteSetup.getPageCrawler().getFullPath(suiteSetup); 


String pagePathName - PathParser.render(pagePath); 
buffer.append("!include -setup .") 
.append(pagePathName) 
.append("\n"); 


} 
WikiPage setup = 
PageCrawlerImpl.getInheritedPage("SetUp", wikiPage); 


Pi 


xb 
= 
= 


if (setup != null) 1 
WikiPagePath setupPath = 
wikiPage.getPageCrawler().getFullPath(setup); 
String setupPathName - PathParser.render(setupPath); 
buffer.append("!include -setup .") 
.append(setupPathName) 
.append("\n"); 


} 
buffer.append(pageData.getContent()); 
if (pageData.hasAttribute("Test")) { 
WikiPage teardown = 
PageCrawlerImpl.getMmheritedPage("TearDown", wikiPage); 
if (teardown != null) { 
WikiPagePath tearDownPath = 
wikiPage.getPageCrawler().getFullPath(teardown); 
String tearDownPathName = PathParser.render(tearDownPath); 
buffer.append("\n") 
.append("'include -teardown .") 
.append(tearDownPathName) 
.append("\n"); 
} 
if (includeSuiteSetup) { 
WikiPage suiteTeardown = 
PageCrawlerImpl.getInheritedPage( 
SuiteResponder. SUITE TEARDOWN NAME, 
wikiPage 


); 
if (suiteTeardown != null) { 
WikiPagePath pagePath = 
suiteTeardown.getPageCrawler().getFullPath 
(suiteTeardown); 
String pagePathName = PathParser.render(pagePath); 
buffer.append("!include -teardown .") 
.append(pagePathName) 
.append(" n"); 


} 
pageData.setContent(buffer.toString()); 
return pageData.getHtml(); 

} 

tx DER T 030. 大 概 没有 。 有 太 多 事 发 生 ， 有 太 多 不 同 层 级 
的 抽象 。 奇 怪 的 字符 串 和 函数 调用 ， 混 以 双重 舱 套 、 用 标识 来 控制 的 和 
语句 等 ， 不 一 而 足 。 

不 过 ， 只 要 做 几 个 简单 的 方法 抽 离 和 重 命名 操作 ， 加 上 一 点 点 重 
构 ， 就 能 在 9 行 代码 之 内 搞 搞 〈 如 代码 清单 3-2 所 示 ) 。 用 3 分 钟 阅读 以 
下 代码 ， 看 你 能 理解 吗 ? 

代码 清单 3-2 HtmlUtil.java ( 重 构 之 后 ) 


public static String renderPageWithSetupsAndTeardowns( 


PageData pageData, boolean isSuite 
) throws Exception { 
boolean isTestPage = pageData.hasAttribute("Test"); 
if (isTestPage) { 


WikiPage testPage = pageData.getWikiPage(); 
StringBuffer newPageContent = new StringBuffer(); 
includeSetupPages(testPage, newPageContent, isSuite); 
newPageContent.append(pageData.getContent()); 
includeTeardownPages(testPage, newPageContent, isSuite); 
pageData.setContent(newPageContent.toString()); 
} 
return pageData.getHtml(); 
} 
除非 你 正在 研究 FitNesse, FUMES TAHI o Nt, UA 
MAHA, FERRATE ERAN ERMA MIRTO, BRE 
染 为 HTML 的 操作 。 如 果 你 熟悉 JUnit[2]， 或 许 会 想到 ， 该 函数 归属 于 
某 个 基于 Web 的 测试 框架。 而 且 ， 这 当然 没 错 。 从 代码 清单 3-2 中 获得 
言 妃 很 容易 ， 而 代码 清单 3-1 则 星 深 难 明 。 
是 什么 让 代码 清单 3-2 易 于 阅读 和 理解 ? 怎么 才能 让 函数 表达 其 意 
图 ?该 给 函数 赋予 哪些 属性 ， 好 让 读者 一 看 就 明白 函数 是 属于 怎样 的 
程序 ? 


3.1 友人 小 


函数 的 第 一 规则 是 要 短小 。 第 二 条 规则 是 还 要 更 短小 。 我 无 法 证 
明 这 个 断言 。 我 给 不 出 任何 证 实 了 小 函数 更 好 的 研究 结果 。 我 能 说 的 
是 ， 近 40 年 来 ， 我 写 过 各 种 不 同 大 小 的 函数 。 我 写 过 令 人 民 恶 的 长 达 
3000 行 的 厌 物 ， 也 写 过 许多 100 行 到 300 行 的 函数 ， 我 还 写 过 20 行 到 30 
行 的 。 经 过 漫长 的 试 错 ， 经 验 告诉 我 ， 函 数 就 该 小 。 


在 20 世 纪 80 年 代 ， 我 们 常 说 函数 不 该 长 于 一 屏 。 当 然 ， 说 这 话 的 
时 候 ，VT100 屏 幕 只 有 24 行 、80 列 ， 而 编辑 器 束 得 先 占 去 4 行 空 间 放 沫 
单 。 如 今 ， 用 上 了 精致 的 字体 和 宽大 的 显示 器 ， 一 屏 里 面 可 以 显示 100 
行 ， 每 行 能 容纳 150 个 字符 。 每 行 都 不 应 该 有 150 个 字符 那么 长 。 画 数 
也 不 该 有 100 行 那么 长 ，20 行 封顶 最 佳 。 

HAE RIAA ze dA? 1991 年 ， 我 去 Kent Beck fiz F X 8j [x] JI 

(Oregon) 的 家 中 拜访 。 我 们 坐 到 一 起 写 了 些 代 码 。 他 给 我 看 一 个 叫 
Sparkle (KENE) 的 有 趣 的 Java/Swing 小 程序 。 程 序 在 屏幕 上 描画 
电影 Cinderella 〈《 灰 姑娘 》) 中 仙女 用 魔 棱 造 出 的 那 种 视觉 效果 。 只 
要 移动 鼠标 ， 光 标 所 在 处 就 会 爆发 出 一 团 令 人 欣喜 的 火花 ， 沿 着 模拟 
重力 场 划 落 到 窗口 底部 。 肯 特 给 我 看 代码 的 时 候 ， 我 惊讶 于 其 中 那些 
玉 数 尺寸 之 小 。 我 看 惯 了 Swing 程 序 中 长 度数 以 里 计 的 函数 。 但 这 个 程 
序 中 每 个 函数 都 具有 两 行 、 三 行 或 四 行 长 。 每 个 函数 都 一 目 了 然 。 
个 函数 都 只 说 一 件 事 。 而 且 ， 每 个 函数 都 依 序 把 你 带 到 下 一 个 函数 。 
这 就 是 函数 应 该 达到 的 短小 程度 ! [3] 

函数 应 该 有 多 短小 ? 通常 来 说 ， 应 该 短 于 代码 清单 3-2 中 的 函数 ! 
代码 清单 3-2 实 在 应 该 缩短 成 代码 清单 3-3 这 个 样子 。 

代码 清单 3-3 HtmlUtil.java (再 次 重 构 之 后 ) 


public static String renderPageWithSetupsAndTeardowns( 


PageData pageData, boolean isSuite) throws Exception { 
if (isTestPage(pageData)) 
includeSetupAndTeardownPages(pageData, isSuite); 
return pageData.getHtml(); 
j 
代码 块 和 缩 进 
许 语句、else 语 句 、while 语 句 等 ， 其 中 的 代码 块 应 该 只 有 一 行 。 该 
行 大 抵 应 该 是 一 个 函数 调用 语句 。 这 样 不 但 能 保持 函数 短小 ， 而 且 ， 
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这 也 意味 着 函数 不 应 该 大 到 足以 容纳 内 套 结 构 。 所 以 ， 画 数 的 缩 
进 层 级 不 该 多 于 一 层 或 两 层 。 当 然 ， 这 样 的 函数 易于 阅读 和 理解 。 


3.2 只 做 一 件 事 


代码 清单 3-1 显 然 想 做 好 几 件 事 。 它 创建 缓冲 区 、 获 取 页 面 、 搜 索 
继承 下 来 的 页 面 、 泻 染 路 径 、 添 加 神秘 的 字符 串 、 生 成 HTML， 如 此 等 
等 。 代 码 清单 3-1 手 忙 脚 配 。 而 代码 清香 3-3 则 只 做 一 件 价 单 的 事 。 它 将 
设置 和 拆 解 包 纳 到 测试 页 面 中 。 

过 去 30 年 以 来 ， 以 下 建议 以 不 同形 式 一 再 出 现 ; 

函数 应 该 做 一 件 事 。 做 好 这 件 事 。 只 做 这 一 件 事 。 

问题 在 于 很 难 知 道 那 件 该 做 的 事 是 什么 。 代 码 清单 3-3 只 做 了 一 件 
事 ， 对 吧 ? 其 实 也 很 容易 看 作息 三 件 事 : 

(1) 判断 是 否 为 测试 页 面 ; 
(2) 如 果 是 ， 则 容纳 进 设置 和 分 拆 步 又 ; 
(3) HTML ° 


那 件 事 是 什么 ? 函数 是 做 了 一 件 事 呢 ， 还 是 做 了 三 件 事 ? 注意 ， 
这 三 个 步骤 均 在 该 国 数 名 下 的 同一 抽象 尾 上 。 可 以 用 简 涪 的 TO[ 颖 起头 
段落 来 描述 这 个 函数 : 

TO RenderPageWithSetupsAndTeardowns, we check to see whether the 
page is a test page and if so, we include the setups and teardowns. In either 
case we render the page in HTML ° 

(# RenderPageWithSetupsAndTeardowns, $% Æ JI Ale G&A Jl iC 
A, MREMAA, BEWAKEN AER ° LICE GWA, A 
EXHTML) 

如 果 画 数 只 是 做 了 该 函数 名 下 同一 抽象 层 上 的 步 又 ， 则 函数 还 是 
只 做 了 一 件 事 。 编 写 函 数 毕竟 是 为 了 把 大 一 些 的 概念 FEZ, KM 
的 名 称 ) 拆 分 为 另 一 抽象 层 上 的 一 系列 步 又。 


代码 清单 3-1 明 显 包 括 了 处 于 多 个 不 同 抽 象 层级 的 步骤 。 显 然 ， 它 
所 做 的 不 止 一 件 事 。 即 便 是 代码 清单 3-2 也 有 两 个 抽象 层 ， 这 已 被 我 们 
将 其 缩短 的 能 力 所 证 明 。 然 而 ， 很 难 再 将 代码 清单 3-3 做 有 意义 的 缩 
短 。 了 可 以 将 主语 句 拆 出 来 做 一 个 名 为 ipncludeSetupAndTeardonws 
IfTestpage 的 函数 ， 但 那 只 是 重新 诠释 代码 ， 并 未 改变 抽象 层级 。 

所 以 ， 要 判断 函数 是 否 不 止 做 了 一 件 事 ， 还 有 一 个 方法 ， 就 是 看 
是 否 能 再 拆 出 一 个 函数 ， 该 函数 不 仅 只 是 单纯 地 重新 诠释 其 实现 
[G34] ° 

函数 中 的 区 段 

请 看 代码 清单 47。 注 意 ，generatePrimes 函数 被 切 分 为 
declarations ` initializations#ll sieve = X PX » X Wi ER BV WS AK Ze HJ T 
征兆 。 只 做 一 件 事 的 函数 无 法 被 合理 地 切 分 为 多 个 区 段 。 


3.3 每 个 nd 7 


EDAD EROR FER, NAPO ETE [8] — fil C E. © 
一 眼 残 能 看 出 ， 代 码 清 单 3-1 he Sik RAAB «JD EUR getHtml( ) 等 
位 于 较 高 抽象 层 的 概念 ， 也 有 String pagePathName = 
PathParser.render(pagePath) 等 位 于 中 间 抽 象 层 的 概念 ， 还 有 .append("\n") 
等 位 于 相当 低 的 抽象 层 的 概念 。 

函数 中 混杂 不 同 抽 和 象 层 级 ， 往 往 让 人 迷惑 。 读 者 可 能 无 法 判断 某 
个 表达 式 是 基础 概念 还 是 细节 。 更 恶劣 的 是 ， 束 像 破 损 的 窗户 ， 一旦 
细 广 与 基础 概念 混杂 ， 更 多 的 细节 就 会 在 范 数 中 纠结 起 来 。 

自 顶 向 下 读 代码 : 向 下 规则 

我 们 想 要 让 代码 拥有 上 自 顶 向 下 的 阅读 顺序 。[5] 我 们 想 要 让 每 个 函 
数 后 面 都 跟着 位 于 下 一 抽象 层级 的 画 数 ， 这 样 一 来 ， 在 查看 函数 列表 
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换 一 种 说 法 。 我 们 想 要 这 样 读 程序 : 程序 就 像 是 一 系列 TO 起 头 的 
段落 ， 每 一 段 都 描述 当前 抽象 层级 ， 并 引用 位 于 下 一 抽象 层级 的 后 续 
TO 起 头 段 落 。 

To include the setups and teardowns, we include setups, then we include 
the test page content, and then we include the teardowns. (ZRAZ Ei fll Zi 
KER, NASMRESZ, Kap) Wann, ANI 
KR ° ) 

To include the setups, we include the suite setup if this is a suite, then 
we include the regular setup. (ARMIER, VIAE EE, DMN EE 
FRADE, SUG ADA TIRES o) 


To include the suite setup, we search the parent hierarchy for 


the “SuiteSetUp”page and add an include statement with the path of that 
page. (ZERAMEEF KALE, wR SuiteSetUp" AMA EKRIR 
AR. PRM M PELA BEA GJ o) 

To search the parent...  (SEfE E...) 

程序 员 往 往 很 难 学 会 遵循 这 条 规则 ， 写 出 只 停留 于 一 个 抽象 层级 
上 的 函数 。 尽 管 如 此 ， 学 习 这 个 扩 巧 还 是 很 重要 。 这 是 保持 函数 短 
小 、 确 保 只 做 一 件 事 的 要 诀 。 让 代码 读 起 来 像 是 一 系列 目 顶 向 下 的 TO 
起 头 段落 是 保持 抽象 层级 协调 一 致 的 有 效 技 巧 。 

看 看 本 章 末尾 的 代码 请 单 3-7。 它 展示 了 遵循 这 条 原则 重 构 的 完整 
testableHtml 函 数 。 留 意 每 个 函数 是 如 何 引 出 下 一 个 函数 ， 如 何 保持 在 
同一 抽象 层 上 的 。 


3.4 switch 语 名 


写 出 短小 的 switch 语 句 很 难 [6]。 即 便 是 只 有 两 种 条 件 的 switch 语 名 
也 要 比 我 想 要 的 单个 代码 块 或 函数 大 得 多 。 写 出 只 做 一 件 事 的 switch 语 
句 也 很 难 。Switch 天 生 要 做 N 件 事 。 不 入 我 们 总 无 法 避 开 switch 语 句 ， 
in EISE HE HA US RET switch Fi HE ee a 级 ， 而 且 永 远 不 重 

。 当然 ， 我 们 利用 多 态 来 实现 这 一 

请 看 代码 清单 3-4。 它 呈 现 了 可 能 依赖 于 雇员 类 型 的 仅仅 一 种 操 
作 。 

代码 清单 3-4 Payroll.java 

public Money calculatePay(Employee e) 


throws InvalidEmployeeType 1 
switch (e.type) 1 
case COMMISSIONED: 
return calculateCommissionedPay(e); 
case HOURLY: 
return calculateHourlyPay(e); 
case SALARIED: 
return calculateSalariedPay(e); 
default: 
throw new InvalidEmployeeType(e.type); 


} 

该 函数 有 好 几 个 问题 。 首 先 ， 它 太 长 ， 当 出 现 新 的 雇员 类 型 时 ， 
还 会 变 得 更 长 。 其 次 ， 它 明显 做 了 不 止 一 件 事 。 第 三 ， 它 违反 了 单一 
权 责 原则 (Single Responsibility Principle[7], SRP) ， 因 为 有 好 几 个 修 
改 它 的 理由 。 第 四 ， 它 违反 了 开放 闭合 原则 (Open Closed Principle[8], 
OCP) ， 因 为 每 当 添 加 新 类 型 时 ， 束 必须 修改 之 。 不 过 ， 该 函数 最 麻 
烦 的 可 能 是 到 处 篆 有 类 似 结构 的 函数 。 例 如 ， 可 能 会 


isPayday(Employee e, Date date), 

或 

deliverPay(Employee e, Money pay), 

如 此 等 等 。 它 们 的 结构 都 有 同样 的 问题 

该 问题 的 解决 方案 (如 代码 清单 3-5 所 示 ) 是 将 Switch 语句 埋 到 抽 
和 象 工 三 [9] 压 下 ， 不 让 任何 人 看 到 。 该 工厂 使 用 switch 语 句 为 Employee 的 
派生 物 创建 适当 的 实体 ， 而 不 同 的 函数 ， 如 calculatePay、isPayday 和 和 
deliverPay 等 ， 则 大 由 Employee 接 口 多 态 地 接受 派 遗 。 


对 于 switch 语 句 ， 我 的 规矩 是 如 末 只 出 现 一 次 ， 用 于 创建 多 仿 对 


忍 [G23]。 当 然 也 要 就 事 论 事 ， 有 了 时 我 也 会 部 分 或 全 部 违反 这 条 规矩 。 
代码 清单 3-5 Employee 与 工厂 
public abstract class Employee { 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 


public interface EmployeeFactory { 
public Employee makeEmployee(EmployeeRecord r) throws 
InvalidEmployeeType; 


public class EmployeeFactoryImpl implements EmployeeFactory 1 
public Employee makeEmployee(EmployeeRecord r) throws 
InvalidEmployeeType { 
switch (r.type) { 


case COMMISSIONED: 
return new CommissionedEmployee(r) ; 
case HOURLY: 
return new HourlyEmployee(r); 
case SALARIED: 
return new SalariedEmploye(r); 
default: 
throw new InvalidEmployeeType(r.type); 


3.5 pie ee A yh 
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SetupTeardownIncluderrender。 这 个 名 称 好 得 多 ， 因 为 它 较 好 地 摘 述 了 
函数 做 的 事 。 我 也 给 每 个 私有 方法 取 个 同样 具有 描述 性 的 名 称 ， 如 
isTestable 或 includeSetupAndTeardownPages。 好 名 称 的 价值 怎么 好 评 都 
不 为 过 。 记 住 沃 德 原则 : “如 果 每 个 例 程 都 让 你 感到 深 合 己 意 ， 那 就 是 
整洁 代码 。” 要 遵循 这 一 原则 ， 泰 半 工 作 都 在 于 为 只 做 一 件 事 的 小 函数 
取 个 好 名 字 。 画 数 越 短小 、 功 能 越 集中 ， 残 越 便 于 取 个 好 名 字 ° 

别 害怕 长 名 称 。 长 而 具有 描述 性 的 名 称 ， 要 比 短 而 令 人 费解 的 名 
称 好 。 长 而 具有 描述 性 的 名 称 ， 要 比 描述 性 的 长 注释 好 。 使 用 某 种 命 
名 约定 ， 让 函数 名 称 中 的 多 个 单词 容易 阅读 ， 然 后 使 用 这 些 单词 给 函 
数 取 个 能 说 清 其 功用 的 名 称 。 


别 害怕 花 时 间 取 和 名字 。 你 当 壬 试 不 同 的 名 称 ， 实 测 其 阅读 效 采 。 
在 Eclipse 或 IntelliJ 等 现代 IDE 中 改名 称 易如反掌 。 使 用 这 些 IDE 测 试 不 
同名 称 ， 直 至 找到 最 具有 摘 述 性 的 那 一 个 为 止 。 

选择 摘 述 性 的 名 称 能 理 清 你 天 于 模块 的 设计 思路 ， 并 帮 你 改进 
之 。 人 退 索 好 名 称 ， 往 往 导 致 对 代码 的 改善 重 构 。 

命名 方式 要 保持 一 致 。 使 用 与 模块 名 一 脉 相 承 的 短语 、 名 词 和 动 
w 24 EN # dp 4 © fl 如 , includeSetupAndTeardownPages ^ 
includeSetupPages ` includeSuiteSetupPage fl includeSetupPage SE ° jx 46 
名 称 使 用 了 类 似 的 措辞 ， 依 序 讲 出 一 个 故事 。 实 际 上 ， 假 使 我 只 给 你 
E E ii K Zt YF Y, Ra e H P: “includeTeardownPages ^ 
includeSuiteTeardownPages filincludeTeardownPage X. Z UN? ”这 就 是 所 


谓 " 深 合 已 意 "了 。 


RLSM ee (SUN), BRE 
数 ) ， 再 次 是 二 〈 双 参数 函数 ) ， 应 尽量 ; pape B 
足够 特殊 的 理由 才能 用 三 个 以 上 参数 〈 多 参数 函数 ) 一 所 以 无 论 如 
何 也 不 要 这 么 做 。 

参数 不 易 对 付 。 它 们 带 有 太 多 概念 性 。 所 以 我 在 代码 范例 中 几乎 
不 加 参数 。 比 如 ， 以 StringBuffer 为 例 ， 我 们 可 能 不 把 它 作 为 实体 变 
量 ， 而 是 当 作 参 数 来 传递 ， 那 样 的 话 ， 读 者 每 次 看 到 它 都 得 要 翻译 一 
裔 。 阅 读 模 块 所 讲述 的 故事 时 ，indudeSetupPage( ) X FE 
includeSetupPageInto (newPage-Content) 易于 理解 。 参 数 与 函数 名 处 在 
不 同 的 抽象 层级 ， 它 要 求 你 了 解 目 前 并 不 特别 重要 的 细 市 ( 即 那 个 
StringBuffer) ° 


从 测试 的 角度 看 ， 参 数 甚至 更 叫 人 为 难 。 想 想 看 ， 要 编写 能 确保 
参数 的 各 种 组 合 运 行 正 常 的 测试 用 例 ， 是 多 么 困难 的 事 。 如 有 果 没 有 参 
数 ， 吏 是 小 菜 一 矶 。 如 有 果 只 有 一 个 参数 ， 也 不 太 困 难 。 有 两 个 参数 ， 
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输出 参数 比 输入 参数 还 要 难以 理解 。 读 函数 时 ， 我 们 惯 于 认为 信 
奶 通 过 参数 输入 函数 ， 通 过 返回 值 从 函数 中 和 输出。 我 们 不 太 期 望 信 息 
通过 参数 输出 。 所 以 ， 输 出 参数 往往 让 人 否 思 之 后 才 悦 然 大 悟 。 

相 较 于 没有 参数 ， 只 有 一 个 输入 参数 算是 第 二 好 的 做 法 。 
SetupTeardownInclude.render (pageData) 也 相当 易于 理解 。 很 明显 ， 
我 们 将 泻 染 pageData 对 象 中 的 数据 。 


3.6.1 一 元 函数 的 普遍 形 子 


向 函数 传 入 单个 参数 有 两 种 极 普 禹 的 理由 。 你 也 许 会 问 关 于 那个 
参数 的 问题 ， 就 像 在 boolean fileExists("MyFile") 中 那样 。 也 可 能 是 操作 
该 参数 ， 将 其 转换 为 其 他 什么 东西 ， 再 输出 之 。 例 如 ，InputStream 
fileOpen("MyFile") 把 String 类 型 的 文件 名 转换 为 InputStream 类 型 的 返回 
值 。 这 就 是 读者 看 到 函数 时 所 期 得 的 东西 。 你 应 当 远 用 较 能 区 别 这 两 
种 理由 的 名 称 ， 而 且 总 在 一 致 的 上 下 文中 使 用 这 两 种 形式 。 

DAH RAIA Si ARAN PSR, Wee 
fF (event) 。 在 这 种 形式 中 ， 有 输入 参数 而 无 输出 参数 。 程 序 将 函数 
看 作 是 一 个 事件 ， 使 用 该 参数 修改 系统 状态 ， 例 如 void 
passwordAttemptFailedNtimes(int attempts)。 人 小 心 使 用 这 种 形式 。 应 该 让 
读者 很 清楚 地 了 解 它 是 个 事件 。 谍 慎 地 选用 名 称 和 上 下 文 语 境 。 

尽量 避免 编写 不 遵循 这 些 形 式 的 一 元 函数 ， 例 如 ，void 
includeSetupPageInto(StringBuffer pageText)。 对 于 转换 ， 使 用 输出 参数 
而 非 返 回 值 令 人 迷惑 。 如 果 函 数 要 对 输入 参数 进行 转换 操作 ， 转 换 结 
RZA AREA ° ERE, StringBuffer transform(StringBuffer in) 


要 比 void transform(StringBuffer oub 强 ， 即 便 第 一 种 形式 只 简单 地 返回 
输 参数 也 是 这 样 。 人 至 少 ， 它 遵循 了 转换 的 形式 。 


3.6.2 标识 参数 


标识 参数 丑陋 不 坊 。 回 函数 传 入 布尔 值 简 直 束 是 骇人听闻 的 做 
法 。 这 样 做 ， 方 法 签名 立刻 变 得 复杂 起 来 ， 大 声 宣 布 本 函数 不 止 做 一 
件 事 。 如 有 果 标 识 为 tue 将 会 这 样 做 ， 标 识 为 false 则 会 那样 做 ! 

在 代码 请 单 3-7 中 ， 我 们 别 无 选择 ， 因 为 调用 者 已 经 传 入 了 那个 标 
识 ， 而 我 想 把 重 构 范 围 限 制 在 该 范 数 及 该 函数 以 下 范围 之 内 。 方 法 调 
用 render(true) 对 于 可 怜 的 读者 来 说 仍然 措 不 厦 头 脑 。 卷 动 屏 幕 ， 看 到 
render(Boolean isSuite])， 稍 许 有 点 帮助 ， 不 过 仍然 不 够 。 应 该 把 该 函数 
一 分 为 二 : reanderForSuite( ) 和 renderForSingleTest( ) ° 


3.6.3 二 元 函数 


E WAT S BY KAE LE — 76 ER BOUE TS è MIN, writeField(name) FE 
writeField(outputStream,name)[10] H fE © 

尽管 两 种 情况 下 意义 都 很 清楚 ， 但 第 一 个 只 要 扫 一 眼 就 明白 ， 更 
好 地 表达 了 其 意义 。 第 二 个 就 得 和 暂停 一 下 才能 明白 ， 除 非 我 们 学 会 名 
格 第 一 个 参数 。 而 且 最 终 那 也 会 导致 问题 ， 因 为 我 们 根本 束 不 该 色 略 
任何 代码 。 忽 略 掉 的 部 分 束 是 缺陷 藏 刁 之 地 。 

当然 ， 有 些 时 候 两 个 参数 正好 。 例 如 ，Point p = new Point(0,0); E 
相当 合理 。 人 第 卡 儿 点 天 生 拥 有 两 个 参数 。 如 果 看 到 new Point(0)， 我 们 
会 倍 感 惊 证。 然而， 本 例 中 的 两 个 参数 却 只 是 单个 值 的 有 序 组 成 部 
分 ! 而 output-Stream 和 name 则 既 非 自然 的 组 合 ， 也 不 是 上 自然 的 排序 。 

即便 是 如 assertEquals(expected, actual) 3x FF AY — JE EN & th A È [RH] 
题 。 你 有 多 少 次 会 搞 错 actual 和 expected 的 位 置 呢 ? 这 两 个 参数 没有 自 
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小 心 ， 使 用 二 元 函数 要 付出 代价 。 你 应 该 尽量 利用 一 些 机 制 将 其 转换 
成 一 元 函数 。 例 如 ， 可 以 把 writeField 方法 写成 outputStream 的 成 员 之 
一 ， 从 而 能 这 样 用 : outputStream.writeField(name) ° EX, th a) DAE 
outputStream 写 成 当前 类 的 成 员 变 量 ， 从 而 无 需 再 传递 它 。 还 可 以 分 离 
出 类 似 FieldWriter 的 新 类 ， 在 其 构造 器 中 采用 outputStream， 并 且 包 含 


一 个 write 方法 。 


3.6.4 三 元 函数 


有 三 个 参数 的 函数 要 比 二 元 函数 难 懂 得 多 。 排 序 、 琢 兢 、 忽 上 略 的 
问题 都 会 加 倍 体现 。 建 议 你 在 写 三 元 函数 前 一 定 要 想 清 楚 。 

例如 ， 设 想 assertEquals 有 三 个 参数 : assertEquals(message, 
expected, actual)。 有 多 少 次 ， 你 读 到 message, AK E Æ expected 
Me? 我 就 常 栽 在 这 个 三 元 函数 上 。 实 际 上 ， 每 次 我 看 到 这 里 ， 总 会 绕 
半天 圈子 ， 最 后 学 会 了 名 上 略 message 参 数 。 

男 一 方面 ， 这 里 有 个 并 不 那么 险恶 的 三 元 罚 数 : assertEquals(1.0, 
amount, .001)。 昌 然 也 要 费 点 神 ， 还 是 值得 的 。 得 到 * 浮 点 值 的 等 值 是 
相对 而 言 ”的 提示 总 是 好 的 。 


3.6.5 参数 对 象 


如 有 果 函 数 看 来 需要 两 个 、 三 个 或 三 个 以 上 参数 ， 就 说 明 其 中 一 些 
参数 应 该 封闭 为 类 了 。 例 如 ， 下 面 两 个 声明 的 差别 : 
Circle makeCircle(double x, double y, double radius); 


Circle makeCircle(Point center, double radius); 


从 参数 创建 对 象 ， 从 而 减少 参数 数量 ， 看 起 来 像 是 在 作弊 ， 但 实 
则 并 非 如 此 。 当 一 组 参数 被 共同 传递 ， 束 像 上 例 中 的 x 和 y 那 样 ， 往 往 
就 是 该 有 目 己 名 称 的 某 个 概念 的 一 部 分 。 


3.6.6 BRA 


有 时 ， 我 们 想 要 加 函数 传 入 数量 可 变 的 参数 。 例 如 ，String.format 
方法 

String.format("%s worked 96.2f hours.", name, hours); 

如 果 可 变 参 数 像 上 例 中 那样 被 同等 对 待 ， 就 和 类 型 为 List 的 单个 参 
数 没 什么 两 样 。 这 样 一 来 ，String.formate 实 则 是 二 元 函数 。 下 列 
String.format 的 声明 也 很 明显 是 二 元 的 : 

public String format(String format, Object... args) 

同 理 ， 有 可 变 参 数 的 函数 可 能 是 一 元 、 二 元 甚至 三 元 。 超 过 这 个 
数量 就 可 能 要 犯错 了 。 


void monad(Integer... args); 


void dyad(String name, Integer... args); 


void triad(String name, int count, Integer... args); 


3.6.7 动词 与 关键 字 


给 函数 取 个 好 名 字 ， 能 较 好 地 解释 范 数 的 意图 ， 以 及 参数 的 顺序 
和 意图 。 对 于 一 元 画 数 ， 函 数 和 参数 应 当 形 成 一 种 非常 良好 的 动词 /名 
词 对 形式 。 例 如 ，write(name) 束 相当 令 人 认同 。 不 管 这 个 “name” 是 什 
A, HE write" » 更 好 的 名 称 大 概 是 writeField(name)， 它 告诉 我 们 ， 
‘mame” 是 一 个 “field”。 

最 后 那个 例子 展示 了 函数 名 称 的 关键 字 (keyword) 形式 。 使 用 这 
种 形式 ， 我 们 把 参数 的 名 称 编码 成 了 函数 和 名。 例如 ，assertEqual 改 成 


assertExpectedEqualsA ctual(expected, actual) 可 能 会 好 些 。 这 大 大 减轻 了 
记忆 参数 顺序 的 负担 。 


3.7 | 
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起 来 的 事 。 有 了 时 ， 它 会 对 目 己 类 中 的 变量 做 出 未 能 预期 的 改动 有 
上 时 ， 它 会 把 变量 搞 成 回 琅 数 传递 的 参数 或 是 系统 全 局 变量 。 无 论 哪 种 
情况 ， 都 是 具有 破坏 性 的 ， 会 导致 古怪 的 时 序 性 耦合 及 顺序 依赖 。 

以 代码 清单 3-6 中 看 似 无 伤 大 雅 的 砂 数 为 例 。 该 画 数 使 用 标准 算法 
来 匹配 userName 和 password。 如果 匹配 成 功 ， 返 回 tue， 如 果 失 败 则 返 
E] false。 但 它 会 有 副作用 。 你 知道 问题 所 在 吗 ? 

代码 清单 3-6 UserValidator.java 

public class UserValidator { 


private Cryptographer cryptographer; 
public boolean checkPassword(String userName, String password) { 
User user = UserGateway.findByName(userName); 
if (user != User. NULL) { 
String codedPhrase - user.getPhraseEncodedByPassword(); 
String phrase = cryptographer.decrypt(codedPhrase, password); 
if ("Valid Password". .equals(phrase)) { 
Session. initialize(); 


return true; 


} 


return false; 


} 

} 

ST, RIE RARE T X] Session. initialize( )A Va FA ° checkPassword 
函数 ， 顾 名 思 义 ， 束 是 用 来 检查 密码 的 。 该 名 称 并 未 暗示 它 会 初始 化 
该 次 会 话 。 所 以 ， 当 菜 个 误 信 了 函数 名 的 调用 者 想 要 检查 用 户 有 效 性 
时 ， 歌 得 冒 抹 除 现 有 会 话 数据 的 风险 。 

这 一 副作用 造 出 了 一 次 时 序 性 耦合 。 也 就 是 说 ，checkPassword 只 
能 在 特定 时 刻 调用 (换言之 ， 在 初始 化 会 话 是 安全 的 时 候 调 用 ) 。 如 
宁 在 不 合适 的 时 候 调 用 ， 会 话 数据 束 有 可 能 沉默 地 丢失 。 时 序 性 耦合 
令 人 迷惑 ， 特 别 是 当 它 驱 在 副作用 后 面 时 。 如 有 果 一 定 要 时 序 性 耦合 ， 
束 应 该 在 函数 名 称 中 说 明 。 在 本 例 中 ， 可 以 重 命 名 贺 数 为 
checkPasswordAndInitializeSession， 虽 然 那 还 是 违反 了 “只 做 一 件 事 ” 的 
规则 © 

输出 参数 

参数 多 数 会 税目 然而 然 地 看 作 是 函数 的 输入 。 如 果 你 编 过 好 些 年 
程序 ， 我 担保 你 一 定 被 用 作 输 出 而 非 输入 的 参数 迷惑 过 。 例 如 ; 

appendFooter(s); 

X^ Ka TESS ET AAR ES IS? 或 者 它 把 什么 东西 添加 到 
了 s 后 面 ? s 是 输入 参数 还 是 输出 参数 ? 稍 许 花 点 时 间 看 看 函数 签名 : 

public void appendFooter(StringBuffer report) 

事情 清楚 了 ， 但 付出 了 检查 函数 声明 的 代价 。 你 被 迫 检 查 函 数 俭 
名 ， 束 得 化 上 一 点 时 间 。 应 该 避免 这 种 中 断 思 路 的 事 。 

在 面向 对 象 编程 之 前 的 当月 里 ， 有 时 的 确 需要 输出 参数 。 然 而 ， 
面向 对 象 语言 中 对 输出 参数 的 大 部 分 需求 已 经 消失 了 ， 因 为 this 也 有 输 
出 函数 的 意味 在 内 。 换 言 之 ， 最 好 是 这 样 调 用 appendFooter: 


report.appendFooter(); 
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态 ， 就 修改 所 属 对 象 的 状态 吧 。 


3.8 B Eh 
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该 修改 某 对 象 的 状态 ， 或 是 返回 该 对 象 的 有 关 信 息 。 两 样 都 干 常会 导 
致 混乱 。 看 看 下 面 的 例子 : 

public boolean set(String attribute, String value); 

该 函数 设置 某 个 指定 属性 ， 如 采 成 功 融 返 回 true， 如 果 不 存 在 那个 
属性 则 返回 false。 这 样 束 导致 了 以 下 语句 : 

if (set(" username", "unclebob"))... 

从 读者 的 角度 考虑 一 下 吧 。 这 是 什么 意思 呢 ? 它 是 在 问 username 属 
性 人 是 否 之 前 已 设置 为 unclebob 吗 ? 或 者 它 是 在 问 username 属 性 值 是 否 
成 功 设 置 为 unclebob 呢 ? 从 这 行 调 用 很 难 判断 其 含义 ， 因 为 set 是 动词 还 
是 形容 词 并 不 清楚 。 
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容 词 。 该 语句 读 起 来 像 是 说 “如 采 username 属 性 值 之 前 已 被 设置 为 
uncleob”， 而 不 是 “设置 username 属 性 值 为 unclebob， 看 看 是 否 可 行 ， 然 
后 ...... ”。 要 解决 这 个 问题 ， 可 以 将 set Ex A WE of 44 
setAndCheckIfExists， 但 这 对 提高 if 语句 的 可 读 性 帮助 不 大 。 真 正 的 解 
决 方案 是 把 指令 与 询问 分 隔 开 来 ， 防 止 混 消 的 发 生 : 


if (attributeExists("username")) { 


setAttribute("username", "unclebob"); 


从 指令 式 画 数 返 回 错误 码 轻 微 违反 了 指令 与 询问 分 隔 的 规则 。 它 
鼓励 了 在 站 语句 判断 中 把 指令 当 作 表 达 式 使 用 。 
if (deletePage(page) == E OK) 
pepe ERIS. (ARIS ATRESIA è 
REER, Wie TE BES AL ASH EIR 。 
if (deletePage(page) == E_OK) { 
if (registry.deleteReference(page.name) == E_OK) { 


if (configKeys.deleteKey(page.name.makeKey()) == E_OK){ 
logger.log("page deleted"); 
} else { 
logger.log("configKey not deleted"); 
} 
} else { 
logger.log("deleteReference from registry failed"); 
} 
} else { 
logger.log("delete failed"); 
return E ERROR; 
j 
ACI, ROAR BE Sa RAS, TREE AS LE A 
主 路 径 代 码 中 分 离 出 来 ， 得 到 人 简化: 
try 1 
deletePage(page); 


registry.deleteReference(page.name); 


configKeys.deleteKey(page.name.makeKey()); 
j 
catch (Exception e) { 

logger.log(e.getMessage()); 


3.9.1 抽 离 Try/Catch 代 码 块 


Try/catch 代 码 块 丑陋 不 卉 。 它 们 搞 配 了 代码 结构 ， 把 错误 处 理 与 正 
常 流程 混为一谈 。 最 好 把 try 和 catch 代 码 块 的 主体 部 分 抽 离 出 来 ， 另 外 
JE BER C > 
public void delete(Page page) { 
try 1 
deletePageAndAllReferences(page); 
} 
catch (Exception e) { 
logError(e); 


} 
private void deletePage AndAllReferences(Page page) throws Exception 


deletePage(page); 
registry.deleteReference(page.name); 
configKeys.deleteKey(page.name.makeKey()); 
j 
private void logError(Exception e) 1 


logger.log(e.getMessage()); 


j 

在 上 例 中 ，delete 函 数 只 与 错误 处 理 有 关 。 很 容易 理解 然后 就 忽略 
fi ° deletePageAndAllIReferenceEN Zit A 5j 5t SBR T page K ° THX 
处 理 可 以 忽略 掉 。 有 了 这 样 美 妙 的 区 隔 ， 代 码 就 更 易于 理解 和 修改 
了 。 


3.9.2 错误 处 理 就 是 一 件 事 


畏 数 应 该 只 做 一 件 事 。 错 误 处 理 束 是 一 件 事 。 因 此 ， 处 理 错 误 的 
函数 不 该 做 其 他 事 。 这 意味 着 (如 上 例 所 示 ) 如 果 关 键 字 try 在 某 个 函 
数 中 存在 ， 它 束 该 是 这 个 函数 的 第 一 个 单词 ， 而 且 在 catchyfinally 代 码 
块 后 面 也 不 该 有 其 他 内 容 。 


3.9.3 Errorjava 依 赖 磁铁 


返回 错误 码 通 常 暗示 某 处 有 个 类 或 是 枚 举 ， 定 义 了 所 有 错误 码 。 
public enum Error { 
OK, 
INVALID, 
NO SUCH, 
LOCKED, 
OUT OF RESOURCES, 
WAITING FOR EVENT; 
} 
这 样 的 类 就 是 一 块 依赖 磁铁 (dependency magnet) ; 其 他 许多 类 
都 得 导入 和 使 用 它 。 当 Error 枚 举 修 改 时 ， 所 有 这 些 其 他 的 类 都 需要 重 
新 编译 和 部 署 。[11] 这 对 Error 类 造成 了 负面 压力 。 程 序 员 不 愿 增加 新 的 
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复 用 旧 的 错误 码 ， 而 不 添加 新 的 。 

使 用 异常 替代 错误 码 ， 新 异常 就 可 以 从 异常 类 派生 出 来 ， 无 需 重 
新 编译 或 重新 部 署 [12]。 


3.10 JEZ HCE 


[13] 

回头 仔细 看 看 代码 清单 3-1， 你 会 注意 到 ， 有 个 算法 在 SetUp、 
SuiteSetUp、TearDown 和 SuiteTearDown 中 总 共和 被 重复 了 4 次 。 识 别 重 
复 不 太 容 易 ， 因 为 这 4 次 重复 与 其 他 代码 混在 一 起 ， 而 且 也 不 完全 一 
样 。 这 样 的 重复 还 是 会 导致 问题 ， 因 为 代码 因此 而 肥 肿 ， 且 当 算 法 改 
变 时 需要 修改 4 处 地 方 。 而 且 也 会 增加 4 次 放 过 错误 的 可 能 性 。 


使 用 代码 清单 3-7 中 的 include 方 法 修正 了 这 些 重复 。 再 读 一 遇 那 段 
代码 ， 你 会 注意 到 ， 整 个 模块 的 可 读 性 因为 重复 的 消除 而 得 到 了 提 

重复 可 能 是 软件 中 一 切腹 恶 的 根源 。 许 多 原则 与 实践 规则 都 是 为 
控制 与 消除 重复 而 创建 。 例 如 ， 全 部 考 德 (Codd) [14] 数 据 库 范 式 都 是 
为 消炎 数据 重复 而 服务 。 再 想 想 看 ， 面 向 对 象 编程 是 如 何 将 代码 集中 
到 基 类 ， 从 而 避免 了 了 元 余 。 面 向 方面 编程 (Aspect Oriented 
Programming) 、 面 向 组 件 编程 (Component Oriented Programming) 多 
少 也 都 是 消除 重复 的 一 种 策略 。 看 来 ， 目 子 程序 发 明 以 来 ， 软 件 开发 
领域 的 所 有 创新 都 是 在 不 断 尝试 从 源 代码 中 消炎 重复 。 


3.11 结构 化 编程 


有 些 程序 员 遵 循 Edsger Dijkstra 的 结构 化 编程 规则 [15]。Dijkstra 认 
为 ， 每 个 函数 、 画 数 中 的 每 个 代码 块 都 应 该 有 一 个 入 口 、 一 个 出 口 。 
遵循 这 些 规 则 ， 意 味 着 在 每 个 函数 中 只 该 有 一 个 retum 语 句 ， 循 环 中 不 
能 有 break 或 continue 语 句 ， 而 且 永 永远 远 不 能 有 任何 goto 语 句 。 

我 们 赞成 结构 化 编程 的 目标 和 规范 ， 但 对 于 小 函数 ， 这 些 规则 助 
葵 不 大 。 只 有 在 大 图 数 中 ， 这 些 规 则 才 会 有 明显 的 好 处 。 

所 以 ， 只 要 图 数 集 持 短小 ， 偶 尔 出 现 的 return、break 或 continue 语 
名 没有 坏处 ， 甚 至 还 比 单 和信 单 出 原则 更 具有 表达 力 。 另 外 一 方面 ，goto 
只 在 大 函数 中 才 有 道理 ， 所 以 应 该 尽量 避 侈 使 用 。 


写 代 码 和 写 别 的 东西 很 像 。 在 写 论 文 或 文章 时 ， 你 先 想 什 么 就 写 
什么 ， 人 然后 再 打 麻 它 。 初 稿 也 许 粗 陋 无 序 ， 你 就 其 酌 推 殴 ， 直 至 达到 
你 心目 中 的 样子 。 

我 写 范 数 时 ， 一 开始 都 见长 而 复杂 。 有 太 多 缩 进 和 崩 合 循环 。 有 
过 长 的 参数 列表 。 名 称 是 随意 取 的 ， 也 会 有 重复 的 代码 。 不 过 我 会 配 
上 一 套 单元 测试 ， 窗 六 每 行 丑 陋 的 代码 。 

然后 我 打磨 这 些 代 码 ， 分 解 钞 数 、 修 改名 称 、 消 除 重复 。 我 缩短 
和 重新 安置 方法 。 有 了 时 我 还 拆散 类 。 同 时 保持 测试 通过 。 

最 后 ， 遵 循 本 章 列 出 的 规则 ， 我 组 装 好 这 些 函 数 。 

我 并 不 从 一 开始 吏 按 照 规 则 写 函 数 。 我 想 没 人 做 得 到 o 


3.13 小 结 


每 个 系统 都 是 使 用 某 种 领域 特定 语言 搭建 ， 而 这 种 语言 是 程序 员 
设计 来 接 述 那个 系统 的 。 男 数 是 语言 的 动词 ， 类 是 名 词 。 这 并 非 是 退 
回 到 那 种 认为 需求 文档 中 的 名 词 和 动词 就 是 系统 中 类 和 函数 的 最 初 设 
想 的 可 怕 的 旧 观 念 。 其 实 这 和 是 个 历史 更 久 的 真理 。 编 程 志 术 是 且 一 直 
nata as Ritz © 

大 师 级 程序 员 把 系统 当 作 故事 来 讲 ， 而 不 是 当 作 程序 来 写 。 他 们 
使 用 选 定编 程 语言 提供 的 工具 构建 一 种 更 为 丰富 且 更 具 表 达 力 的 语 
言 ， 用 来 讲 那个 故事 。 那 种 领域 特定 语言 的 一 个 部 分 ， 束 是 摘 述 在 系 
统 中 发 生 的 各 种 行为 的 画 数 层 级 。 在 一 种 狭 独 的 递归 操作 中 ， 这 些 行 
为 使 用 它们 定义 的 与 领域 紧密 相关 的 语言 讲述 目 己 那个 小 故事 。 

本 章 所 讲述 的 是 有 关 编 写 恨 好 函数 的 机 制 。 如 果 你 遵循 这 些 规 
则 ， 画 数 吏 会 短小 ， 有 个 好 名 字 ， 而 且 被 很 好 地 归 置 。 不 过 永远 别 环 
记 ， 真 正 的 目标 在 于 讲述 系统 的 故事 ， 而 你 编写 的 男 数 必须 干净 利落 
地 拼凑 到 一 起 ， 形 成 一 种 精确 而 清晰 的 语言 ， 帮 助 你 讲 故事 。 


3.14 SetupTeardownIncluder 程 序 


代码 清单 3-7 SetupTeardownIncluder.java 
package fitnesse.html; 
import fitnesse.responders.run.SuiteResponder; 
import fitnesse.wiki.*; 
public class SetupTeardownIncluder 1 

private PageData pageData; 

private boolean isSuite; 

private WikiPage testPage; 


private StringBuffer newPageContent; 


private PageCrawler pageCrawler; 
public static String render(PageData pageData) throws Exception 1 


return render(pageData, false); 


public static String render(PageData pageData, boolean isSuite) 
throws Exception 1 
return new SetupTeardownIncluder(pageData).render(isSuite); 
} 
private SetupTeardownIncluder(PageData pageData) { 
this.pageData = pageData; 
testPage = pageData.getWikiPage(); 
pageCrawler = testPage.getPageCrawler(); 
newPageContent = new StringBuffer(); 
} 
private String render(boolean isSuite) throws Exception { 
this.isSuite = isSuite; 
if (isTestPage()) 
includeSetupAndTeardownPages(); 
return pageData.getHtml(); 
} 
private boolean isTestPage() throws Exception { 
return pageData.hasAttribute("Test"); 
} 
private void includeSetupAndTeardownPages() throws Exception { 
includeSetupPages(); 
includePageContent(); 


includeTeardownPages(); 


updatePageContent(); 
} 
private void includeSetupPages() throws Exception { 
if (isSuite) 
includeSuiteSetupPage(); 
includeSetupPage(); 
} 
private void includeSuiteSetupPage() throws Exception { 
include(SuiteResponder.SUITE_SETUP_NAME, "-setup"); 
} 
private void includeSetupPage() throws Exception { 
include("SetUp", "-setup"); 
} 
private void includePageContent() throws Exception { 
newPageContent.append(pageData.getContent()); 
i 
private void includeTeardownPages() throws Exception { 
includeTeardownPage(); 
if (isSuite) 
includeSuiteTeardownPage(); 
} 


private void includeTeardownPage() throws Exception { 


mm 


include("TearDown", "-teardown"); 


} 


private void includeSuiteTeardownPage() throws Exception { 
include(SuiteResponder.SUITE TEARDOWN. NAME, 


teardown"); 


} 


private void updatePageContent() throws Exception { 
pageData.setContent(newPageContent.toString()); 
} 


private void include(String pageName, String arg) throws Exception 


WikiPage inheritedPage = findInheritedPage(pageName); 

if (inheritedPage != null) { 
String pagePathName = getPathNameForPage(inheritedPage); 
buildIncludeDirective(pagePathName, arg); 


} 
private WikiPage findInheritedPage(String pageName) throws 
Exception { 
return PageCrawlerImpl.getInheritedPage(pageName, testPage); 
i 
private String getPathNameForPage(WikiPage page) throws 
Exception { 
WikiPagePath pagePath = pageCrawler.getFullPath(page); 
return PathParser.render(pagePath); 


} 
private void buildIncludeDirective(String pagePathName, String arg) 


newPageContent 
-append("\n! include ") 
.append(arg) 
.append(" .") 


.append(pagePathName) 
.append("\n"); 
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[1]. 原 注 : 一 种 开源 测试 工具 。 见 http://www.fitnese.org ° 
[2]. 原 注 : 一 种 开源 Java 单 元 测试 工具 。 见 http://www.junit.org ° 


[3]. 原 注 : 我 问 肯 特 是 否 还 保留 这 段 程序 ， 他 说 找 不 到 了 “。 RARA 
的 电脑 也 没 找到 。 现 在 只 有 在 记忆 中 有 这 段 程序 了 。 


[4]. 原 注 : LOGO 语 言 中 的 TO 关键 字 ， 与 Ruby 和 Python 中 def 天 键 字 的 用 
i 所 以 ， 每 个 函数 都 以 TO 起 头 。 这 对 函数 的 设计 产生 了 有 趣 的 
All o 


[5]. 原 注 : [KP78] ° 
[6]. 原 注 : 当然 ， 这 也 包括 if/else 语 句 在 内 。 


[7]. 原 注 : a. http:/en.wikipedia.org/wiki/Single_responsibility_principle; 
b. http://www.objectmentor.com/resources/articles/srp.pdf ° 


[8]. 原 注 : a. http://en.wikipedia.org/wiki/Open/closed principle; b. 
http://www.objectmentor.com/resources/articles/ocp.pdf ° 


[9]. 原 注 : [GOF] ° 

LORE: 我 刚 重 构 了 一 个 使 用 了 二 元 形式 的 模块 。 现 在 就 能 把 
outputStream 做 成 该 类 的 一 个 字段 ， 并 把 所 有 对 writeField 的 调用 都 变 作 
一 元 形式 。 结 果 就 干净 多 了 。 


B 那些 以 为 可 以 不 重新 编译 和 部 署 束 扬长 而 去 的 家 伙 最 终 都 日 
TICA ? 


[12]. 原 注 : 这 也 是 开放 闭合 原则 (OCP) 的 一 个 范例 [PPPO2] * 


[13]. 原 注 : DRY 原 则 。[PRAG] ° 
[14]. 译 注 : 艾 德 加 :F: 考 德 (Edgar F. Codd) ， 关 系数 据 库 之 父 。 


[15]. 原 注 : [SP72] ° 


重新 写 吧 。” 
Brian W. Kernighan 与 P J. Plaugher[1] 

什么 也 比 不 上 放置 民 好 的 注释 来 得 有 用 。 什 么 也 不 会 比 乱 七 八 精 
的 注释 更 有 本 事 搞 乱 一 个 模块 。 什 么 也 不 会 比 陈旧 、 提 供 错 误 信 息 的 
注释 更 有 破坏 性 。 

注释 并 不 像 圣 德 勒 的 名 单 。 它 们 并 不 “ 纯 然 地 好 ”。 实 际 上 ， 注 释 
最 多 也 就 是 一 种 必须 的 恶 。 若 编程 语言 足够 有 表达 力 ， 或 者 我 们 长 于 
用 这 些 语言 来 表达 意图 ， 就 不 那么 需要 注释 一 一 也 许 根 本 不 需要 。 


"SUAE TUR DIESE 


注释 的 恰当 用 法 是 弥补 我 们 在 用 代码 表达 意图 时 遭遇 的 失败 。 注 
意 ， 我 用 了 “失败 ”一 词 。 我 是 说 真 的 。 注 释 总 是 一 种 失败 。 我 们 总 无 
法 找到 不 用 注释 就 能 表达 目 我 的 方法 ， 所 以 总 要 有 注释 ， 这 并 不 值得 
i 

如 果 你 发 现 目 己 需要 写 注 释 ， 再 想 想 看 是 否 有 办 法 翻 瘟 ， 用 代码 
来 表达 。 每 次 用 代码 表达 ， 你 都 该 他 奖 一 下 目 己 。 每 次 写 注 释 ， 你 都 
该 做 个 风 脸 ， 感 受 自己 在 表达 能 力 上 的 失败 。 

我 为 什么 要 极力 贬低 注释 ? ALA ERR iin ^ UL ik Vo RU 
或 有 意 如 此 ， 但 出 现 得 实在 太 频 繁 。 注 释 存 在 的 时 间 越 入， 就 离 其 所 
描述 的 代码 越 远 ， 越 来 越 变 得 全 然 错误 。 原 因 很 简单 。 程 序 员 不 能 坚 
持 维护 注释 。 

代码 在 变动 ， 在 演化 。 从 这 里 移 到 那里 。 彼 此 分 离 、 重 造 义 合 到 
一 处 。 很 不 拉 ， 注 释 并 不 总 是 随 之 变动 一 一 不 能 总 是 跟着 走 。 注 释 常 
FLATT CRS a ATOR, FAME, BOR NERA ° Dn, 
看 看 以 下 注释 以 及 它 本 来 要 描述 的 代码 行 变 成 了 什么 样子 : 

MockRequest request; 

private final String HTTP DATE REGEXP = 

"[SMTWF][a-z]{2}\\,\\s[0-9] {2 }\\s[JFMASOND |[a-z] 2] Ns" 
"[0-9]{4}\\s[0-9]{2}\\:[0-9]{2}\\:[0-9]{2}\\SGMT"; 


private Response response; 


private FitNesseContext context; 

private FileResponder responder; 

private Locale saveLocale; 

// Example: "Tue, 02 Apr 2003 22:18:49 GMT" 

TEHTTP DATE REGEXP7S si RETEREZIA, A n Bet A SC 


体 变量 。 


程序 员 应 当 负 责 将 注释 保持 在 可 维护 、 有 关联 、 精 确 的 高 度 。 我 
同意 这 种 说 法 。 但 我 更 主张 把 力气 用 在 写 清 楚 代 码 上 ， 直 接 保 证 无 须 
编写 注释 。 

不 准确 的 注释 要 比 没 注释 坏 得 多 。 它 们 满口 胡言 。 它 们 预期 的 东 
西 水 不 能 实现 。 它 们 设 定 了 无 需 也 不 应 再 遵循 的 旧 规 则 。 

真实 只 在 一 处 地 方 有 : 代码 。 只 有 代码 能 忠实 地 告诉 你 它 做 的 
事 。 那 古 唯 一 真正 准确 的 信息 来 源 。 所 以 ， 尽 管 有 时 也 需要 注释 ， 我 
们 也 该 多 花心 思 尽 量 减 少 注释 量 。 


4.1 } \ 能 美化 JAN 


GIERIITATIZ se PR CB o RITRAE 
R, ASWEGADNILS-CCAGSGXIADH. CET RITIRO 
Ci: "UE, RES IER! ”不 ! 最 好 是 把 代码 弄 干净 ! 

市 有 少量 注释 的 整洁 而 有 表达 力 的 代码 ， 要 比 市 有 大 量 注释 的 零 
雁 而 复杂 的 代码 像样 得 多 。 与 其 化 时 间 编 写 解 释 你 摘出 的 粳 糕 的 代码 
的 注释 ， 不 如 伦 时 间 清 滞 那 堆 糟 料 的 代码 。 


4.2 用 代码 来 阐述 


有 时 ， 代 码 本 吴 不 足以 解释 其 行为 。 不 笠 的 是 ， 许 多 程序 员 据 此 
以 为 代码 很 少 一 一 如 果 有 的 话 一 一 能 做 好 解释 工作 。 这 种 观点 纯 属 错 
误 。 你 愿意 看 到 这 个 : 

// Check to see if the employee is eligible for full benefits 

if ((employee.flags & HOURLY FLAG) && 


(employee.age > 65)) 
还 是 这 个 ? 
if (employee.isEligibleForFullBenefits()) 
只 要 想 上 那么 几 秒 钟 ， 就 能 用 代码 解释 你 大 部 分 的 意图 。 很 多 时 
候 ， 人 简单 到 只 需要 创建 一 个 描述 与 注释 所 言 同一 事物 的 函数 即 可 。 


4.3 好 ; 


有 些 注释 是 必须 的 ， 也 是 有 利 的 。 来 看 看 一 些 我 认为 值得 写 的 注 
释 。 不 过 要 记 住 ， 唯 一 真正 好 的 注释 是 你 想 办 法 不 去 写 的 注释 。 


4.3.1 法 律 信息 


有 时， 公司 代码 规范 要 求 编 写 与 法 律 有 关 的 注释 。 例 如 ， 版 权 及 
著作 权 声 明 就 是 必须 和 有 理由 在 每 个 源 文 件 开 头 注释 处 放置 的 内 容 。 

下 例 是 我 们 在 FitNesse 项 目 每 个 源 文件 开头 放置 的 标准 注释 。 我 可 
以 很 开心 地 说 ，IDE 上 自动 卷 起 这 些 注 释 ， 这 样 就 不 会 显得 凌乱 了 。 

// Copyright (C) 2003,2004,2005 by Object Mentor, Inc. All rights 


reserved. 


// Released under the terms of the GNU General Public License version 
2 or later. 

这 类 注释 不 应 是 合同 或 法 典 。 只 要 有 可 能 ， 就 指向 一 份 标准 许可 
或 其 他 外 部 文档 ， 而 不 要 把 所 有 条 款 放 到 注释 中 。 


4.3.2 提供 信息 的 注 


有 时， 用 注释 来 提供 基本 信息 也 有 其 用 处 。 例 如 ， 以 下 注释 解释 
了 茶 个 抽象 方法 的 返回 值 : 

// Returns an instance of the Responder being tested. 

protected abstract Responder responderlInstance(); 

这 类 注释 有 时 管用 ， 但 更 好 的 方式 是 尽量 利用 函数 名 称 传达 信 
晨 。 比 如 ， 在 本 例 中 ， 只 要 把 函数 重新 命名 为 responderBeingTested， 
ERB SRA ° 

下 例 稍 好 一 些 : 

// format matched kk:mm:ss EEE, MMM dd, yyyy 

Pattern timeMatcher = Pattern.compile( 

"\\d*:\\d*:\\d* \\w*, \\w* \\d*, \\d*"); 

在 本 例 中 ， 注 释 说 明 ， 该 正则 表达 式 意 在 匹配 一 个 经 由 
SimpleDateFormat.format 芳 数 利用 特定 格式 字符 串 格式 化 的 时 间 和 日 
期 。 同 样 ， 如 果 把 这 段 代 码 移 到 某 个 转换 日 期 和 时 间 格 式 的 类 中 ， 整 
会 更 好 、 更 消 晰 ， 而 注释 也 就 变 得 多 此 一 举 了 。 


4.3.3 对 意图 的 解释 


有 时 ， 注 释 不 仅 提 供 了 有 关 实 现 的 有 用 信息 ， 而 且 还 提供 了 某 个 
决定 后 面 的 意图 。 在 下 例 中 ， 我 们 看 到 注释 反映 出 来 的 一 个 有 趣 决 
定 。 在 对 比 两 个 对 象 时 ， 作 者 决定 将 他 的 类 放置 在 比 其 他 东西 更 高 的 
位 置 。 

public int compareTo(Object o) 

{ 

if(o instanceof WikiPagePath) 
{ 
WikiPagePath p = (WikiPagePath) o; 


String compressedName = StringUtil.join(names, ""); 
String compressedArgumentName = StringUtil.join(p.names, ""); 
return compressedName.compareTo(compressedArgumentName); 
} 
return 1; // we are greater because we are the right type. 
} 
下 面 的 例子 甚至 更 好 。 你 也 许 不 同意 程序 员 给 这 个 问题 提供 的 解 
决 方案 ， 但 至 少 你 知道 他 想 干 什么 。 
public void testConcurrentAddWidgets() throws Exception { 
WidgetBuilder widgetBuilder — 
new WidgetBuilder(new Class[](BoldWidget.class]); 
String text = """bold text"""; 


ParentWidget parent = 
new BoldWidget(new MockWidgetRoot(), "bold text""); 
AtomicBoolean failFlag = new AtomicBoolean(); 
failFlag.set(false); 
//This is our best attempt to get a race condition 
//by creating large number of threads. 
for (int i = 0; i < 25000; i++) { 
WidgetBuilderThread widgetBuilderThread = 
new WidgetBuilderThread(widgetBuilder, text, parent, failFlag); 
Thread thread = new Thread(widgetBuilderThread); 
thread.start(); 
} 
assertEquals(false, failFlag.get()); 


4.3.4 阐释 


AW, ERA EE MARE MEE A BIA SCORE [LIES SC E 79 Rh n] 
读 形式 ， 也 会 是 有 用 的 。 通 常 ， 更 好 的 方法 是 尽量 让 参数 或 返回 值 目 
HIER: 但 如 果 参 数 或 返回 值 是 某 个 标准 库 的 一 部 分 ， 或 是 你 
不 能 修改 的 代码 ， 帮 助 阐释 其 作 义 的 代码 就 会 有 用 。 
public void testCompareTo() throws Exception 
{ 
WikiPagePath a = PathParser.parse("PageA"); 
WikiPagePath ab = PathParser.parse("PageA.PageB"); 
WikiPagePath b = PathParser.parse("PageB"); 
WikiPagePath aa = PathParser.parse("PageA.PageA"); 
WikiPagePath bb = PathParser.parse("PageB.PageB"); 
WikiPagePath ba = PathParser.parse("PageB.PageA"); 


assert True(a.compareTo(a) == 0); // a == 


assert True(a.compareTo(b) != 0); // a != b 
assertTrue(ab.compareTo(ab) == 0); // ab == ab 
assertTrue(a.compareTo(b) == -1); //a < b 
assert True(aa.compareTo(ab) == -1); // aa < ab 
assert True(ba.compareTo(bb) == -1); // ba < bb 
assertTrue(b.compareTo(a) == 1); //b> a 
assertTrue(ab.compareTo(aa) == 1); // ab > aa 
assert True(bb.compareTo(ba) == 1); // bb > ba 

} 

当然 ， 这 也 会 冒 曾 释 性 注释 本 号 殉 不 正确 的 风险 。 回 头 看 看 上 

例 ， 你 会 发 现 想 要 确认 注释 的 正确 性 有 多 难 。 这 一 方面 说 明了 阐释 有 


多 必要 ， 田 外 也 说 明了 它 有 风险 。 所 以 ,在 写 这 类 注释 之 前 ， 考 虑 一 


下 是 否 还 有 更 好 的 办 法 ， 然 后 再 加 倍 小 心地 确认 注释 正确 性 。 
4.3.5 警示 


有 时 ， 用 于 警告 其 他 程序 员 会 出 现 某 种 后 果 的 注释 也 是 有 用 的 。 
例如 ， 下 面 的 注释 解释 了 为 什么 要 关闭 某 个 特定 的 测试 用 例 : 
// Don't run unless you 
// have some time to kill. 
public void _testWithReallyBigFile() 
{ 
writeLines ToFile(10000000); 


response.setBody(testFile); 
response.ready ToSend(this); 
String responseString = output.toString(); 
assertSubString("Content-Length: 1000000000", responseString); 
assert True(bytesSent > 1000000000); 
} 
当然 ， 如 今 我 们 多 数 会 利用 附 上 恰当 解释 性 字符 串 的 @Ignore 属性 
来 关闭 测试 用 例 。 比 如 @Ignore("Takes too long to run[2]")。 但 在 JUnit4 
之 前 的 日 子 里 ,惯常 的 做 法 是 在 方法 名 前 面 加 上 下 划 线 。 如 果 注 释 足 
够 有 说 服 力 ， 束 会 很 有 用 了 。 
x BUR AP SCRI ALT 
public static SimpleDateFormat makeStandardHttpDateFormat() 
{ 


//SimpleDateF ormat is not thread safe, 


//so we need to create each instance independently. 
SimpleDateFormat df = new SimpleDateFormat("EEE, dd MMM 
yyyy HH:mm:ss z"); 
df.setTimeZone(TimeZone.getTimeZone("GMT")); 
return df; 
j 
你 也 许 会 抱怨 说 ， 还 会 有 更 好 的 解决 方法 。 我 大 概 会 同意。 不 过 
ai 竺 ， 它 能 阻止 某 位 急切 的 程序 员 以 效率 之 名 
使 用 静态 初始 大 。 


4.3.6 TODO 注 释 


有 时 ， 有 理由 用 /TODO 形式 在 源 代码 中 放置 要 做 的 工作 列表 。 在 
PAF, TODO 注释 解释 了 为 什么 该 函数 的 实现 部 分 无 所 作为 ， 将 来 
应 该 是 怎样 。 

//TODO-MdM these are not needed 

// We expect this to go away when we do the checkout model 

protected VersionInfo makeVersion() throws Exception 

{ 

return null; 

} 

TODO 是 一 种 程序 员 认 为 应 该 做 ， 但 由 于 某 些 原因 目前 还 没 做 的 工 
作 。 它 可 能 是 要 提醒 删除 某 个 不 必要 的 特性 ， 或 者 要 求 他 人 注意 某 个 
问题 。 它 可 能 是 县 请 别人 取 个 好 名 字 ， 或 者 提示 对 依赖 于 某 个 计划 事 
件 的 修改 。 无 论 TODO 的 目的 如 何 ， 它 都 不 是 在 系统 中 留 下 糟糕 的 代码 
的 借口 。 

如 今 ， 大 多 数 好 IDE 都 提供 了 特别 的 手段 来 定位 所 有 TODO 注 释 ， 
这 些 注 释 看 来 于 不了。 你 不 会 愿意 代码 因为 TODO 的 存在 而 变 成 一 堆 垃 
圾 ， 所 以 要 定期 查看 ， 删 除 不 再 需要 的 。 


4.3.7 放大 
注释 可 以 用 来 放大 某 种 看 来 不 合理 之 物 的 重要 性 。 


String listItemContent = match.group(3).trim(); 


// the trim is real important. It removes the starting 

// spaces that could cause the item to be recognized 

// as another list. 

new ListItemWidget(this, listItemContent, this.level + 1); 
return buildList(text.substring(match.end())); 


4.3.8 公共 API 中 的 J avadoc 


没有 什么 比 被 良好 描述 的 公共 API 更 有 用 和 令 人 满意 的 了 。 标 准 
Java 库 中 的 Javadoc 殉 是 一 例 。 没 有 它们 ， 写 Java 程 序 束 会 变 得 很 难 。 

如 果 你 在 编写 公共 API， 就 该 为 它 编写 民 好 的 Javadoc。 不 过 要 记 住 
本 章 中 的 其 他 建议 。 怠 像 其 他 注释 一 样 ，Javadoc 也 可 能 误导 、 不 适用 
或 者 提供 错误 信息 。 


4.4 MY 


大 多 数 注 释 都 属 此 类 。 通 向 ， 坏 注释 都 是 糟 糙 的 代码 的 文 返 或 借 
口 ， 或 者 对 错误 决策 的 修正 ， 基 本 上 等 于 程序 员 自 说 上 自 话 。 


4.4.1 TES EH TE 


如 果 只 是 因为 你 觉得 应 该 或 者 因为 过 程 需要 就 添加 注释 ， 那 就 是 
无 谓 之 举 。 如 果 你 决定 写 注 释 ， 束 要 伦 必要 的 时 间 确 保 写 出 最 好 的 注 
例如 ， 我 在 FitNesse 中 找到 的 这 个 例子 ， 例 中 的 注释 大 概 确 实 有 
用 。 不 过 ， 作 者 太 着急 ， 或 者 没 太 伦 心思。 他 的 哺 哺 目 语 变 成 了 一 个 
谜团 。 
public void loadProperties() 
{ 
try 
{ 
String propertiesPath = _ propertiesLocation + "/ + 
PROPERTIES FILE; 


FileInputStream propertiesStream = new 
FileInputStream(propertiesPath); 
loadedProperties.load(propertiesStream); 
} 
catch(IOException e) 
{ 


// No properties files means all defaults are loaded 


} 

catch 代 码 块 中 的 注释 是 什么 意思 昵 ? 显然 对 于 作者 有 其 意义 ， 不 
过 并 没有 好 到 足够 的 程度 。 很 明显 ， 如 果 出 现 IOException， 就 表示 没 
有 属性 文件 ， 在 那 种 情况 下 ， 载 入 默认 设置 。 但 谁 来 效 载 默认 设置 
We? 会 在 对 loadProperties.load 之 前 装载 吗 ? 抑或 1oadProperties.load 捕 获 
Fo RPE ` AERA? 再 或 1oadProperties.load 在 尝试 
载 入 文件 前 就 装载 所 有 默认 设置 ? 要 么 作者 只 是 在 安奈 自己 别 在 意 
catch 代码 块 的 留 空 ? 或 者 一 一 这 种 可 能 最 可 怕 一 一 作者 是 想 告 诉 目 
己 ， 将 来 再 回头 写 疼 载 默认 设置 的 代码 ? 

我 们 唯 有 检视 系统 其 他 部 分 的 代码 ， 弄 清 事 情 原 委 。 任 何 迫 使 读 
者 查看 其 他 模块 的 注释 ， 都 没 能 与 读者 沟通 好 ， 不 值 所 费 。 


4.4.2 多 余 的 注 


代码 清单 4-1 展 示 的 人 简单 钞 数 ， 其 头 部 位 置 的 注释 全 属 多 余 。 读 这 
段 注释 花 的 时 间 没 准 比 读 代 码 伦 的 时 间 还 要 长 。 

代码 清单 4-1 waitForClose 

// Utility method that returns when this.closed is true. Throws an 


exception 


// if the timeout is reached. 
public synchronized void waitForClose(final long timeoutMillis) 
throws Exception 
{ 
if(!closed) 
{ 
wait(timeoutMillis); 
if(!closed) 
throw new Exception("MockResponseSender could not be 
closed"); 
} 
} 
这 段 注 释 起 了 什么 作用 ? 它 并 不 能 比 代 码 本 喘 提供 更 多 的 信息 。 
它 没 有 证 明代 码 的 意义 ， 也 没有 给 出 代码 的 意图 或 逻辑 。 读 它 并 不 比 
读 代 码 更 容易 。 事 实 上 ， 它 不 如 代码 精确 ， 误 导读 者 接受 不 精确 的 信 
息 ， 而 不 是 正确 地 理解 代码 。 它 就 像 个 自 来 熟 的 二 手 车 贩子 ， 满 口 保 
证 你 不 用 打开 发 动机 新 查验 。 
来 看 看 代码 清单 4-2 中 摘自 Tomcat 项 目的 无 用 而 多 余 的 Javadoc 吧 。 
注释 只 是 一 味 将 代码 搞 得 含糊 不 明 。 完 全 没有 文档 上 的 价值 。 下 
列 出 了 靠 前 面 的 一 些 代 码 ， 后 续 模 块 中 还 有 许多 类 似 情 况 。 
代码 清单 4-2 ContainerBase.java (Tomcat) 


public abstract class ContainerBase 


ju 
面 只 


implements Container, Lifecycle, Pipeline， 
MBeanRegistration, Serializable { 
[EF 

* The processor delay for this component. 


di; 


protected int backgroundProcessorDelay - -1; 
/炒米 
* The lifecycle event support for this component. 
SI 
protected LifecycleSupport lifecycle = 
new LifecycleSupport(this); 
[PF 
* The container event listeners for this Container. 
2 
protected ArrayList listeners = new ArrayList(); 
[EF 
* The Loader implementation with which this Container is 
* associated. 
Ey 
protected Loader loader = null; 
[** 
* The Logger implementation with which this Container is 
* associated. 
*/ 
protected Log logger = null; 
Visita 
* Associated logger name. 
dl 
protected String logName = null; 
[PE 
* The Manager implementation with which this Container is 


* associated. 


gi 
protected Manager manager - null; 
[PE 
* The cluster with which this Container is associated. 
ui 
protected Cluster cluster = null; 
/炒米 
* The human-readable name of this Container. 
g 
protected String name = null; 
[EF 
* The parent Container to which this Container is a child. 
*/ 
protected Container parent = null; 
[PF 
* The parent class loader to be configured when we install a 
* Loader. 
si 
protected ClassLoader parentClassLoader = null; 
[EF 
* The Pipeline object with which this Container is 
* associated. 
*/ 
protected Pipeline pipeline = new StandardPipeline(this); 
[PE 
* The Realm with which this Container is associated. 
*/ 


protected Realm realm - null; 

/炒米 
* The resources DirContext object with which this Container 
* is associated. 
zi 


protected DirContext resources = null; 
4.4.3 误导 性 注释 


有 时 ， 尽 管 初 袁 可 嘉 ， 程 序 员 还 是 会 写 出 不 够 精确 的 注释 。 想 想 
看 代码 请 单 4-1 中 那 多 余 而 又 有 误导 嫌疑 的 注释 吧 。 

你 有 没有 发 现 那样 的 注释 是 如 何 误 导读 者 的 ? 在 this.closed 变 为 true 
的 时 候 ， 方 法 并 没有 返回 。 方 法 只 在 判断 到 this.closed 为 true 的 时 候 返 
回 ， 人 否则 ， 束 只 是 等 竺 遥遥 无 期 鸭 超时 ， 然 后 如 采 判 断 this.closed 还 是 
jEtrue, NLIS — T FR e 

这 一 细微 的 误导 信息 ， 放 在 比 代 码 本 身 更 难 阅读 的 注释 里 面 ， 有 
可 能 导致 其 他 程序 员 快 活 地 调用 这 个 函数 ， 并 期 望 在 this.closed 变 为 true 
时 立即 返回 。 那 位 可 怜 的 程序 员 将 会 发 现 自己 陷于 调试 困境 之 中 ， 拼 
命 想 找 出 代码 执行 得 如 此 之 慢 的 原因 。 


HP, 


444 循 规 式 注释 


所 谓 每 个 函数 都 要 有 Javadoc 或 每 个 变量 都 要 有 注释 的 规矩 全 然 是 
思春 可 笑 的 。 这 类 注释 徒然 让 代码 变 得 散乱 ， 满 口 胡言 ， 令 人 迷惑 不 
解 。 

例如 ， 要 求 每 个 函数 都 要 有 Javadoc， 就 会 得 到 类 似 代码 清单 4-3 那 
样 面目 可 民 的 代码 。 这 类 废话 只 会 搞 乱 代码 ， 有 可 能 误导 读者 。 

代码 清单 4-3 


pee 
* 
* @param title The title of the CD 
* @param author The author of the CD 
* @param tracks The number of tracks on the CD 
* (param durationInMinutes The duration of the CD in minutes 
*/ 
public void addCD(String title, String author, 
int tracks, int durationInMinutes) { 
CD cd = new CDO; 
cd.title = title; 
cd.author = author; 
cd.tracks = tracks; 
cd.duration = duration; 
cdList.add(cd); 


4.4.5 日 志 式 注释 


有 人 会 在 每 次 编辑 代码 时 ， 在 模块 开始 处 添加 一 条 注释 。 这 类 注 
释 就 像 古 一 种 记录 每 次 修改 的 日 志 。 我 见 过 满 篇 尽 是 这 类 日 志 的 代码 
模块 。 

* Changes (from 11-Oct-2001) 

* 11-Oct-2001 : Re-organised the class and moved it to new package 


* com.jrefinery.date (DG); 


* 05-Nov-2001 : Added a getDescription() method, and 
NotableDate 


ok 


eliminated 


class (DG); 


* 12-Nov-2001 : IBD requires 


NotableDate 


* 


setDescription() method, now that 


class is gone (DG); 
getPreviousDayOfWeek(), 


* 


Changed 


getNearestDayOfWeek() 


* 


getFollowingDayOfWeek() and 
to correct 
bugs (DG); 

* 05-Dec-2001 : Fixed bug in SpreadsheetDate class (DG); 
* 29-May-2002 : Moved the month constants into a separate interface 
$ (MonthConstants) (DG); 

* 27-Aug-2002 : Fixed bug in addMonths() method, thanks to N??? 
levka Petr (DG); 


* 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 
* 13-Mar-2003 : Implemented Serializable (DG); 

* 29-May-2003 : Fixed bug in addMonths method (DG); 
* 04-Sep-2003  : Implemented 


Comparable. 
isInRange javadocs (DG); 


Updated the 
* 05-Jan-2005 : Fixed bug in addYears() method (1096282) (DG); 
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时 ， 我 们 还 没有 源 代码 控制 系统 可 用 。 如 今 ， 这 种 见长 的 记录 只 会 让 

模块 变 得 北 配 不 堪 ， 应 当 全 部 删除 。 


4.4.6 废话 注释 


BIN, AES E RITA CU DS T ANZ. ARIA 
1K, ETA ° 

[ee 

* Default constructor. 

2 

protected AnnualDateRule() 1 

j 

对 吧 ? 再 看 看 这 个 : 

/** The day of the month. */ 

private int dayOfMonth; 

还 有 这 样 的 废话 模范 : 

Li 

* Returns the day of the month. 

* 

* @return the day of the month. 

2 

public int getDayOfMonth() 1 

return dayOf Month; 

j 

这 类 注释 废话 连篇 ， 我 们 都 学 会 了 视而不见 。 读 代码 时 ， 眼 光 不 
会 停留 在 它们 上 面 。 最 终 ， 当 代码 修改 之 后 ， 这 类 注释 就 变 作 了 谎言 
一 堆 。 

代码 清单 4-4 中 的 第 一 条 注释 貌似 还 行 [3]。 它 解释 了 catch 代 码 块 为 
何 被 名 略 。 不 过 第 二 条 注释 就 纯 是 废话 了 。 显 然 ， 该 程序 员 诅 起 于 编 
写 函 数 中 那些 try/catch 代 码 块 。 

代码 清单 4-4 startSending 


private void startSending() 


try 
{ 
doSending(); 
} 
catch(SocketException e) 
{ 
// normal. someone stopped the request. 
} 
catch(Exception e) 
{ 
try 
{ 
response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 
} 
catch(Exception e1) 
{ 


// Give me a break! 


} 

RAT SIME RIE, MB MARIE), AEM 
感 可 以 由 改进 代码 结构 而 消除 。 他 应 该 把 力气 花 在 将 最 末 一 个 try/catch 
代码 块 拆 解 到 单独 的 国 数 中 ， 如 代码 清单 4-5 所 示 。 

代码 清单 4-5 startSending 〈 重 构 之 后 ) 


private void startSending() 


try 


doSending(); 
} 
catch(SocketException e) 
{ 
//normal. someone stopped the request. 
} 
catch(Exception e) 
{ 
addExceptionAndCloseResponse(e); 


} 
private void addExceptionAndCloseResponse(Exception e) 
{ 
try 
{ 
response.add(ErrorResponder.makeExceptionString(e)); 
response.closeAll(); 
} 
catch(Exception e1) 
{ 
} 
} 
FASE RISD elie RIE o Re ACER EI CENE 
优秀 、 更 快乐 的 程序 员 。 


是 什么 ? BR: 无 。 


4.4.7 可 怕 的 废话 


Javadoc 也 可 能 是 废话 。 下 列 Javadoc (来 自 某 知名 开源 库 ) 的 目的 
它们 只 是 产 目 某 种 提供 文档 的 不 当 愿 望 的 废话 注 


/** The name. */ 

private String name; 

/** The version. */ 

private String version; 

/** The licenceName. */ 
private String licenceName; 
/** The version. */ 

private String info; 


再 仔细 读 读 这 些 注 释 。 你 是 否 发 现 了 剪 切 -粘贴 错误 ?” 如果 作者 在 


tj 《或 粘贴 ) 注释 时 都 没 花 心思 ， 怎 么 能 指望 读者 从 中 获 益 呢 ? 


4.4.8 能 用 函数 或 变量 时 就 别 用 注释 
看 看 以 下 代码 概要 : 


// does the module from the global list <mod> depend on the 


// subsystem we are part of? 
if 


(smodule.getDependSubsystems().contains(subSysMod.getSubSystem())) 


可 以 改 成 以 下 没有 注释 的 版 本 : 
ArrayList moduleDependees = smodule.getDependSubsystems(); 
String ourSubSystem = subSysMod.getSubSystem(); 


if (moduleDependees.contains(ourSubSystem)) 


代码 原作 者 可 能 (DAR) 是 先 写 注释 再 编写 代码 。 不 过 ， 作 者 
应 该 重 构 代 码 ， 如 我 所 做 的 那样 ， 从 而 删 挥 注释 。 


4.4.9 位 置 标记 


有 时 ， 程 序 员 喜欢 在 源 代 码 中 标记 某 个 特别 位 置 。 例 如 ， 最 近 我 
在 程序 中 看 到 这 样 一 行 : 

// Actions 717774 

把 特定 函数 是 放 在 这 种 标记 栏 下 面 ， 多 数 时 候 实 属 无 理 。 鸡 零 狗 
碎 ， 理 当 删 除 一 一 符 别 是 尾部 那 一 长 囊 无 用 的 斜 杜 。 

这 么 说 吧 。 如 果 标 记 栏 不 多 ， 束 会 显而易见 。 所 以 ， 尽 量 少 用 标 
记 栏 ， 只 在 特别 有 价值 的 时 候 用 。 如 来 滥 用 标记 栏 ， 束 会 沉没 在 背景 
噪音 中 ， 被 忽略 掉 。 


4.4.10 括号 后 面 的 注释 


有 时 ， 程 序 员 会 在 括号 后 面 放置 特殊 的 注释 ， 如 代码 清单 4-6 所 
示 。 尽 管 这 对 于 含有 深度 骸 套 结构 的 长 钞 数 可 能 有 意义 ， 但 只 会 给 我 
们 更 愿意 编写 的 短小 、 封 装 的 函数 带 来 混乱 。 如 果 你 发 现 目 己 想 标记 
右 括号 ， 其 实 应 该 做 的 是 缩短 函数 。 

代码 清单 4-6 wc.java 


public class wc 1 


public static void main(String[] args) 1 
BufferedReader in - new BufferedReader(new 
InputStreamReader(System.in)); 
String line; 
int lineCount = 0; 


int charCount = 0; 


int wordCount = 0; 
try 1 
while ((line = in.readLine()) != null) 1 
lineCount++; 
charCount += line.length(); 
String words[] = line.split("\\W"); 
wordCount += words.length; 
} //while 
System.out.println("wordCount = " + wordCount); 
System.out.println("lineCount = " + lineCount); 
System.out.println("charCount = " + charCount); 
) // try 
catch (IOException e) 1 
System.err.println("Error:" + e.getMessage()); 


) //catch 
} //main 
j 
4.4.11 归属 与 署名 
/* Added by Rick */ 


源 代码 控制 系统 非常 善于 记 住 是 谁 在 何 时 添加 了 什么 。 没 必要 用 
那些 小 小 的 签名 搞 脏 代码 。 你 也 许 会 认为 ， 这 种 注释 大 概 有 助 于 他 人 
了 解 应 该 和 谁 讨论 这 上 段 代码 。 不 过 ， 事 实 却 是 注释 在 那儿 放 了 一 年 又 
一 年 ， 越 来 越 不 准确 ， 越 来 越 和 原作 者 没关系 。 

重申 一 下 ， 源 代码 控制 系统 是 这 类 信息 最 好 的 归属 地 。 


4.4.12 注释 掉 的 代码 


直接 把 代码 注释 掉 是 讨厌 的 做 法 。 别 这 么 干 ! 
InputStreamResponse response = new InputStreamResponse(); 
response.setBody(formatter.getResultStream(), 
formatter.getByteCount()); 

// InputStream resultsStream = formatter.getResultStream(); 

// StreamReader reader = new StreamReader(resultsStream); 

// response.setContent(reader.read(formatter.getByteCount())); 

其 他 人 不 敢 删 除 注 释 挥 的 代码 。 他 们 会 想 ， 代 码 依 然 放 在 那儿 ， 
一 定 有 其 原因 ， 而 且 这 段 代码 很 重要 ， 不 能 删除 。 注 释 掉 的 代码 堆积 
EE, WERAMERA e 

看 看 以 下 来 自 Apache 公 共 库 的 代码 : 

this.bytePos = writeBytes(pngIdBytes, 0); 

//hdrPos - bytePos; 

writeHeader(); 

writeResolution(); 

//dataPos = bytePos; 

if (writeImageData()) { 

writeEnd(); 
this.pngBytes = resizeByteArray(this.pngBytes, this.maxPos); 
È 
else{ 
this.pngBytes=null; 

} 

return this.pngBytes; 

PATINATA ZARE? 它们 重要 吗 ? 它们 搁 在 那儿 ， 是 为 
了 给 未 来 的 修改 做 提示 吗 ? 或 者 ， 只 是 某 人 在 多 年 以 前 注释 掉 、 懒 得 
清理 的 过 时 玩意 ? 


20 世 纪 60 年 代 ， 曾 经 有 那么 一 段 时 间 ， 注 释 抒 的 代码 可 能 有 用 。 
但 我 们 已 经 拥有 优 民 的 源 代码 控制 系统 如 此 之 久 ， 这 些 系统 可 以 为 我 
们 记 住 不 要 的 代码 。 我 们 无 需 再 用 注释 来 标记 ， 删 掉 即 可 ， 它 们 丢 不 
T ° RII ° 


4.4.13 HTML 注释 


源 代码 注释 中 的 HTML 标 记 是 一 种 大 物 ， 如 你 在 下 面 代码 中 所 见 。 
编辑 絮 /IDE 中 的 代码 本 来 易于 阅读 ， 却 因为 HTML 注释 的 存在 而 变 得 
难以 尘 读 。 如 有 果 注 释 将 由 某 种 工具 (例如 Javadoc) 抽取 出 来 ， 呈现 到 
网 页 ， 那 么 该 是 工具 而 非 程序 员 来 负责 给 注释 加 上 合适 的 HTML 标 签 。 


/ 米 米 


* Task to run fit tests. 

* This task runs fitnesse tests and publishes the results. 

* <p/> 

* «pre» 

* Usage: 

* &lt;taskdef name-&quot;execute-fitnesse-tests& quot; 

* 
classname=&quot;fitnesse.ant.ExecuteFitnesseTestsTask&quot; 

* classpathref-&quot;classpath&quot; /&gt; 

* OR 

* &lt;taskdef classpathref=&quot;classpath&quot; 

E resource-&quot;tasks.properties&quot; /&gt; 

* «p/» 

* &l]t;execute-fitnesse-tests 


È suitepage=&quot;FitNesse.SuiteAcceptanceTests&quot; 


* fitnesseport-&quot;8082&quot; 


* resultsdir=&quot;${results.dir}&quot; 
> resultshtmlpage-&quot;fit-results.html&quot; 
* classpathref=&quot;classpath&quot; /&gt; 
* </pre> 
*/ 
4.4.14 非 本 地 信息 


假如 你 一 定 要 写 注 释 ， 请 确 你 它 搞 述 了 离 它 最 近 的 代码 。 别 在 本 
地 注释 的 上 下 文 环境 中 给 出 系统 级 的 信息 。 以 下 面 的 Javadoc 注释 为 
例 ， 除 了 那 可 怕 的 了 元 余 之 外 ， 它 还 给 出 了 有 关 黑 认 端 口 的 信息 。 不 过 
该 函数 完全 没 控 制 到 那个 所 谓 默 认 值 。 这 个 注释 并 未 描述 该 男 数 ， 而 
苹 在 接 述 系统 中 远 在 他 方 的 其 他 函数 。 当 然 ， 也 无 法 担 体 在 包含 那个 
默认 值 的 代码 修改 之 后 ， 

这 里 的 注释 也 会 跟着 修改 。 


/ 米 米 


* Port on which fitnesse would run. Defaults to <b>8082</b>.* 
* @param fitnessePort 
Si 

public void setFitnessePort(int fitnessePort) 


{ 


this.fitnessePort = fitnessePort; 


4.4.15 信息 过 


ANCE TEE "P S IUE RB ERI TCR JA fx» PUE 
释 来 日 某 个 用 来 测试 base64 编 解码 芳 数 的 模块 。 除 了 RFC 文 档 编 号 之 
外 ， 注 释 中 的 其 他 细节 信息 对 于 读者 完全 没有 必要 。 


/* 


RFC 2045 - Multipurpose Internet Mail Extensions (MIME) 

Part One: Format of Internet Message Bodies 

section 6.8. Base64 Content-Transfer-Encoding 

The encoding process represents 24-bit groups of input bits as output 
strings of 4 encoded characters. Proceeding from left to right, a 
24-bit input group is formed by concatenating 3 8-bit input groups. 
These 24 bits are then treated as 4 concatenated 6-bit groups, each 
of which is translated into a single digit in the base64 alphabet. 
When encoding a bit stream via the base64 encoding, the bit stream 
must be presumed to be ordered with the most-significant-bit first. 
That is, the first bit in the stream will be the high-order bit in 

the first 8-bit byte, and the eighth bit will be the low-order bit in 
the first 8-bit byte, and so on. 

*/ 


4.4.16 不 明显 的 联系 


注释 及 其 棉 述 的 代码 之 间 的 联系 应 该 显而易见 。 如 条 你 不 嫌 麻 烦 


要 写 注 释 ， 至 少 让 读者 能 看 痢 注 释 和 代码 ， 并 且 理 解 注释 所 谈 何 物 。 
以 来 目 Apache 公 共 库 的 这 段 注 释 为 例 : 


/* 


* start with an array that is big enough to hold all the pixels 
* (plus filter bytes), and an extra 200 bytes for header info 


*/ 
this.pngBytes = new byte[((this.width + 1) * this.height * 3) + 200]; 
ESO DAETDAT 与 那个 +1 有 关系 吗 ? 或 与 *3 有 关 ? 还 是 与 两 
BAAR? 为 什么 用 200? 注释 的 作用 是 解释 未 能 目 行 解释 的 代码 。 如 
林 注 释 本 身 还 需要 解释 ， 束 太 遗 憾 了 。 


4.4.17 函数 头 


短 函 数 不 需 要 太 多 描述 。 为 只 做 一 件 事 的 短 函 数 选 个 好 名 字 ， 通 
TS ZEE ZLI o 


4.4.18 非 公 共 1 Vn rH 的 J avadoc 


虽然 Javadoc 对 于 公共 API 非 常 有 用 ， 但 对 于 不 打算 作 公 共用 途 的 代 
码 束 令 人 厌恶 了 。 为 系统 中 的 类 和 函数 生成 Javadoc 页 并 非 总 有 用 ， 而 
Javadoc 注 释 额 外 的 形式 要 求 几乎 等 同 于 八股 文章 。 


4.4.19 范 


我 曾 为 首 个 XP Immersion[4] 课 程 编写 了 代码 清单 4-7 列 出 的 模块 。 
这 个 模块 几乎 是 糟糕 的 代码 和 坏 注释 风格 的 典范 。 后 来 Kent Beck 当 着 
儿 十 位 满腔 热情 的 学 生 的 面 重 构 了 这 些 代码 ， 将 其 变 得 令 人 愉悦 。 后 
2E, dE Agile Software Development, Principles, Patterns, and 
Practices (中 译 版 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》) 和 Software 
Development (软件 开发 ) 杂志 的 “技艺 ”专栏 的 第 一 篇 文章 中 引用 了 这 
个 例子 。 

这 个 模块 最 迷人 的 地 方 是 ， 有 那么 一 阵 ， 我 们 中 的 许多 人 都 认为 
它 “ 文 档 做 得 很 好 ”。 如 今 ， 我 们 认为 它 古 一 小 团 乱 硅 。 看 看 你 能 发 现 
多 少 个 不 同 的 注释 问题 吧 。 


代码 清单 4-7 GeneratePrimes.java 
LI 
* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 
* «p» 
* Eratosthenes of Cyrene, b. c. 276 BC, Cyrene, Libya -- 
* d. c. 194, Alexandria. The first man to calculate the 
* circumference of the Earth. Also known for working on 
* calendars with leap years and ran the library at Alexandria. 
* «p» 
* The algorithm is quite simple. Given an array of integers 
* starting at 2. Cross out all multiples of 2. Find the next 
* uncrossed integer, and cross out all of its multiples. 
* Repeat untilyou have passed the square root of the maximum 
* value. 
* 
* @author Alphonse 
* @version 13 Feb 2002 atp 
=) 
import java.util.*; 
public class GeneratePrimes 
{ 
[ee 
* @param max Value is the generation limit. 
*/ 
public static int[] generatePrimes(int maxValue) 


{ 


if (maxValue >= 2) // the only valid case 
{ 
// declarations 
int s = maxValue + 1; // size of array 
boolean[] f = new boolean[s]; 
int i; 
// initialize array to true. 
for (i = 0; i < s; i++) 
f[i] = true; 
// get rid of known non-primes 
f[0] = f[1] = false; 
// sieve 
int j; 
for (i = 2; i < Math.sqrt(s) + 1; i++) 
{ 
if (f[i]) // if i is uncrossed, cross its multiples. 
{ 
for (j = 2 *i;j<s;jt+=i) 


f[j] = false; // multiple is not prime 


} 
// how many primes are there? 
int count — 0; 
for (i = 0; i < s; i++) 
{ 
if (ffi]) 


count++; // bump count. 


} 

intl] primes = new int[count]; 

// move the primes into the result 

for (i = 0, j = 0; i < s; i++) 

{ 

if (f[i]) // if prime 
primes[j++] = i; 

} 

return primes; // return the primes 
} 
else // max Value < 2 


return new int[0]; // return null array if bad input. 


} 
在 代码 清单 4-8 中 ， 你 可 以 看 到 该 模块 重 构 后 的 版 本 。 注 意 ， 注 释 
的 使 用 被 明显 地 限制 了 。 在 整个 模块 中 只 有 两 个 注释 。 每 个 注释 都 足 
具 说 明和 意义 。 
代码 清单 4-8 PrimeGeneratorjava (EJF) 
fe 
* This class Generates prime numbers up to a user specified 
* maximum. The algorithm used is the Sieve of Eratosthenes. 
* Given an array of integers starting at 2: 
* Find the first uncrossed integer, and cross out all its 
* multiples. Repeat until there are no more multiples 
* jn the array. 
sii 


public class PrimeGenerator 


private static boolean[] crossedOut; 
private static int[] result; 
public static int[] generatePrimes(int max Value) 
{ 
if (maxValue < 2) 
return new int[0]; 
else 
{ 
uncrossIntegersUpTo(max Value); 
crossOutMultiples(); 
putUncrossedIntegersIntoResult(); 


return result; 


} 
private static void uncrossIntegersUpTo(int max Value) 
{ 
crossedOut = new boolean[max Value + 1]; 
for (int i = 2; i < crossedOut.length; i++) 
crossedOut[i] = false; 
} 
private static void crossOutMultiples() 
{ 
int limit = determinelterationLimit(); 
for (int i = 2; i <= limit; i++) 
if (notCrossed(i)) 
crossOutMultiplesOf(i); 


} 


private static int determinelterationLimit() 
{ 
// Every multiple in the array has a prime factor that 
// is less than or equal to the root of the array size, 
// so we don't have to cross out multiples of numbers 
// \arger than that root. 
double iterationLimit = Math.sqrt(crossedOut.length); 
return (int) iterationLimit; 
} 
private static void crossOutMultiplesOf(int i) 
{ 
for (int multiple = 2*i; 
multiple < crossedOut.length; 
multiple += i) 


crossedOut[multiple] = true; 


} 
private static boolean notCrossed(int i) 
{ 
return crossedOut[i] == false; 
} 


private static void putUncrossedIntegersIntoResult() 
{ 
result = new int[numberOfUncrossedIntegers()]; 
for (int j = 0, i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 


result[j++] = i; 


} 
private static int numberOfUncrossedIntegers() 
{ 
int count = 0; 
for (int i = 2; i < crossedOut.length; i++) 
if (notCrossed(i)) 
count++; 


return count; 


} 

很 容易 说 明 ， 第 一 个 注释 完全 是 多 余 的 ， 因 为 它 读 起 来 非常 像 是 
generatePrimes 函数 上 自身。 不 过 ， 我 认为 这 段 注 释 还 是 省 了 读者 去 读 具 
体 算 法 的 精力 ， 所 以 我 倾向 于 留 下 它 。 

第 二 个 注释 显然 很 有 必要 。 它 解释 了 平方 根 作 为 循环 限制 的 理 
由 。 我 找 不 到 能 说 明白 这 个 问题 的 简单 变量 名 或 者 其 他 编程 结构 。 男 
外 ， 对 平方 根 的 使 用 可 能 也 有 点 武断 。 通 过 限制 平方 根 循环 ， 我 是 否 
真 节省 了 许多 时 间 ? 平方 根 计 算 所 花 的 时 间 会 不 会 比 省 下 的 时 间 还 要 
多 ? 这 些 都 值得 考虑 。 使 用 平方 根 作 为 循环 限制 ， 满 足 了 我 这 种 旧式 C 
语言 和 汇编 语言 黑客 ， 不 过 我 可 不 敢 说 抵 得 上 其 他 人 为 理解 它 而 花 的 
时 间 和 精力 。 


4.5 文献 


[KP78] : Kernighan and Plaugher, The Elements of Programming 
Style, 2d. ed., McGraw- Hill, 1978. 


[1]. 原 注 : [KP78], p. 144 © 


[2]. 译 注 : 意 为 “运行 时 间 过 长 ”。 


[3]. 原 注 : IDE 对 注释 中 拼写 检查 的 文 持 对 我 们 这 些 看 大 量 代码 的 人 实 
在 征 一 种 妙 事 。 


[4]. 译 注 : Object Mentor 公 司 开 办 的 极限 编程 深入 课程 。 
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你 应 该 你 持 民 好 的 代码 格式 。 你 应 该 选用 一 套 管 理 代 码 格式 的 简 
单 规则 ， 然 后 贯彻 这 些 规则 。 如 采 你 在 团队 中 工作 ， 则 团队 应 该 一 至 
同意 采用 一 套 简 单 的 格式 规则 ， 所 有 成 员 都 要 遵从 。 使 用 能 帮 你 应 用 
这 些 格式 规则 的 目 动 化 工具 会 很 有 帮助 。 


Del AH i 


先 明确 一 下 ， 代 码 格式 很 重要 。 代 码 格式 不 可 名 略 ， 必 须 严 肃 对 
待 。 代 码 格式 关乎 沟通 ， 而 沟通 是 专业 开发 者 的 头等 大 事 。 

或 许 你 认为 “让 代码 能 工作 ” 才 古 专业 开发 者 的 头等 大 事 。 然 而 ， 
我 布 望 本 书 能 让 你 抛 挥 那 种 想法 。 你 今天 编写 的 功能 ， 极 有 可 能 在 下 
一 版 本 中 被 修改 ， 但 代码 的 可 读 性 却 会 对 以 后 可 能 发 生 的 修改 行为 产 
生 深 远 影响。 原始 代码 修改 之 后 很 人 人 ， 其 代码 风格 和 可 读 性 仍 会 影响 
到 可 维护 性 和 扩展 性 。 即 便 代 码 已 不 复 存 在 ， 你 的 风格 和 律 条 仍 存 活 
e 

那么 ， 哪 些 代 码 格式 相关 方面 能 帮 我 们 最 好 地 沟通 呢 ? 


5.2 垂直 格式 


从 垂直 尺寸 开始 吧 。 源 代码 文件 该 有 多 大 ? 在 Java 中 ， 文 件 尺寸 与 
类 尺寸 极其 相 天 。 讨 论 类 时 再 说 类 的 尺寸 。 现 在 完 考 虑 文件 尺寸 。 

多 数 Java 源 代码 文件 有 多 大 ? 事实 说 明 ， 尺 寸 各 各 不 同 ， 长 度 殊 
异 ， 如 图 5-1 所 示 。 


10000.0 E— 


100.0 L— 


每 个 文件 中 的 代码 行 数 


10.0 


junit fitnesse testNG tam jdepend ant tomcat 


图 5-1 以 对 数 标尺 显示 的 文件 长 度 分 布 (方块 高 度 =sigmal) 

图 5-1 中 涉及 7 个 不 同 项 目 : Junit ^ FitNesse ^ testNG ^ Time and 
Money、JDepend、Ant 和 Tomcat。 贯 穿 方 块 的 直线 两 端 显示 这 些 项 目 中 
最 小 和 最 大 的 文件 长 度 。 方 块 表 示 在 平均 值 以 上 或 以 下 的 大 约 三 分 之 
一 文件 (一 个 标准 偏差 [1]) 的 长 度 。 方 块 中 间 位 置 就 是 平均 数 。 所 以 
FitNesse 项 目的 文件 平均 尺寸 是 65 行 ， 而 上 面 三 分 之 一 在 40 一 100 行 及 
100 行 以 上 之 间 。FitNesse 中 最 大 的 文件 大 约 400 行 ， 最 小 是 6 行 。 这 是 
个 对 数 标尺 ， 所 以 较 小 的 垂直 位 置 差 异 意 味 着 文件 绝对 尺寸 的 较 大 差 
Re 

Junit ` FitNesse#/lTime and Money 由 相对 较 小 的 文件 组 成 。 没 有 一 
个 超过 500 行 ， 多 数 都 小 于 200 行 。Tomcat 和 Ant 则 有 些 文件 达到 数 干 
行 ， 将 近 一 半 文 件 长 于 200 行 。 

对 我 们 来 说 ， 这 意味 着 什么 ? 意味 着 有 可 能 用 大 多 数 为 200 行 、 最 
长 500 行 的 单个 文件 构造 出 色 的 系统 (FitNesse 总 长 约 50000 行 ，。 尽 管 
这 并 非 不 可 违背 的 原则 ， 也 应 该 乐于 接受 。 短 文件 通常 比 长 文件 易于 
理解 。 


5.2.1 [RAE 23 


想 想 看 写 得 很 好 的 报纸 文章 。 你 从 上 到 下 阅读 。 在 顶部 ， 你 期 刻 
有 个 头条 ， 告 诉 你 故事 主题 ， 好 让 你 决定 是 否 要 读 下 去 。 第 一 段 是 整 
个 故事 的 大 纲 ， 给 出 粗 线条 概述 ， 但 隐藏 了 故事 细节 。 接 着 读 下 去 ， 
细 市 渐次 增加 ， 直 至 你 了 解 所 有 的 日 期 、 名 字 、 引 语 、 说 法 及 其 他 细 
节 。 

源 文件 也 要 像 报 纸 文章 那样 。 名 称 应 当 人 简单 且 一 目 了 然 。 名 称 
号 应 该 足够 告诉 我 们 是 否 在 正确 的 模块 中 。 源 文件 最 顶部 应 该 给 出 高 
层次 概念 和 算法 。 细 节 应 该 往 下 渐次 展开 ， 直 至 找到 源 文件 中 最 底层 
AERA ° 

报纸 由 许多 篇 文章 组 成 BUR Re EUR IL ° RO 
有 王 满 一 整 页 的 。 这 样 做 ， 报 纸 才 可 用 。 假 知 一 份 报纸 只 登载 一 篇 长 
故事 ， 其 中 充 太 杷 无 组 织 的 事实 、 日 期 、 名 字 等 ， 没 人 会 去 读 它 。 


5.2.2 概念 间 垂 直方 向 上 的 区 隔 


几乎 所 有 的 代码 都 是 从 上 往 下 读 ， 从 左 往 右 读 。 每 行 展 现 一 个 表 
达 式 或 一 个 子 句 ， 每 组 代码 行 展 示 一 条 完整 的 思路 。 这 些 思路 用 空 日 
tT IX BRIT © 

以 代码 清单 5-1 为 例 。 在 封包 声明 、 导 入 声明 和 每 个 函数 之 间 ， 都 
有 空白 行 隔 开 。 这 条 极其 简单 的 规则 极 大 地 影响 到 代码 的 视觉 外 观 。 
每 个 空白 行 都 是 一 条 线索 ， 标 识 出 新 的 独立 概念 。 往 下 读 代码 时 ， 你 
的 目光 总 会 停留 于 空白 行 之 后 那 一 行 。 

代码 清单 5-1 BoldWidget.java 


package fitnesse.wikitext.widgets; 


import java.util.regex.*; 


public class BoldWidget extends ParentWidget { 


public static final String REGEXP = "”".+? 
private static final Pattern pattern = Pattern.compile("""(.+?)"", 
Pattern. MULTILINE + Pattern. DOTALL 
); 
public BoldWidget(ParentWidget parent, String text) throws 
Exception { 
super(parent); 
Matcher match = pattern.matcher(text); 
match.find(); 
addChildWidgets(match.group(1)); 
} 
public String render() throws Exception { 
StringBuffer html = new StringBuffer("<b>"); 
html.append(childHtml()).append("</b>"); 
return html.toString(); 


} 
如 代码 清单 5-2 所 示 ， 抽 掉 这 些 空 日 行 ， 代 码 可 读 性 减弱 了 不 少 。 
代码 清单 5-2 BoldWidget.java 
package fitnesse.wikitext.widgets; 
import java.util.regex.*; 
public class BoldWidget extends ParentWidget { 
public static final String REGEXP = '""".+?""; 
private static final Pattern pattern = Pattern.compile("""(.+?)", 
Pattern. MULTILINE + Pattern. DOTALL); 
public BoldWidget(ParentWidget parent, String text) throws 


Exception 1 


super(parent); 
Matcher match = pattern.matcher(text); 
match.find(); 
addChildWidgets(match.group(1));} 

public String render() throws Exception { 
StringBuffer html = new StringBuffer("<b>"); 
html.append(childHtml()).append("</b>"); 
return html.toString(); 


} 

在 你 不 特意 注视 时 ， 后 果 就 更 严重 了 。 在 第 一 个 例子 中 ， 代 码 组 
会 跳 到 你 眼中 ， 而 第 二 个 例子 整 像 一 堆 乱 奢 。 两 段 代码 的 区 别 ， 展 示 
了 垂直 方向 上 区 隅 的 作用 。 


5.2.3 垂直 方向 上 的 靠近 


如 有 果 说 空白 行 隔 开 了 概念 ， 靠 近 的 代码 行 则 上 暗示 了 它们 之 间 的 紧 
密 关系 。 所 以 ， 紧 密 相关 的 代码 应 该 互相 靠近 。 注 意 代码 清单 5-3 中 的 
注释 是 如 何 割 断 两 个 实体 变量 间 的 联系 的 。 

代码 清单 5-3 

public class ReporterConfig 1 


[EF 
* The class name of the reporter listener 
di 

private String m_className; 

[EF 


* The properties of the reporter listener 


*/ 
private List<Property> m properties = new ArrayList<Property>(); 
public void addProperty(Property property) 1 
m properties.add(property); 
j 
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样 。 我 一 眼 束 能 看 到 ， 这 是 个 有 两 个 变量 和 一 个 方法 的 类 。 看 上 面 的 
代码 时 ， 我 不 得 不 更 多 地 移动 头 部 和 眼球 ， 才 能 获得 相同 的 理解 度 。 
代码 清单 5-4 
public class ReporterConfig { 


private String m_className; 
private List«Property» m properties = new ArrayList<Property>(); 
public void addProperty(Property property) 1 

m properties.add(property); 


5.2.4 HAPS 


Ke ATER TR PRR, MMAR aa, EN 
SRR, RB FT RALE TPR VE > Oe OR, den AN ia A 
RIO MER ME Be FR PE RIDIRE? it AE 
Te, AARREAITTA, (AES [RORIS 23 E R AE BB 
些 代码 碎片 在 哪里 。 

关系 密切 的 概念 应 该 互相 靠近 [G10]。 显 然 ， 这 条 规则 并 不 适用 于 
分 布 在 不 同文 件 中 的 概念 。 除非 有 很 好 的 理由 ， 否 则 就 不 要 把 关系 密 
切 的 概念 放 到 不 同 的 文件 中 。 实 际 上 ， 这 也 是 避免 使 用 protected 变 量 的 
a 


对 于 那些 关系 密切 、 放 置 于 同一 源 文件 中 的 概念 ， 它 们 之 间 的 区 
阳 应 该 成 为 对 相互 的 易 懂 度 有 多 重要 的 衡量 标准 。 应 避免 迫使 读者 在 
源 文件 和 类 中 跳 来 跳 去 。 

变量 声明 。 变 量 声明 应 尽 可 能 靠近 其 使 用 位 置 。 因 为 贸 数 很 短 ， 
本 地 变量 应 该 在 函数 的 顶部 出 现 ， 束 像 Junit4.3.1 中 这 个 稍 长 的 瑟 数 中 
那样 。 


private static void readPreferences() { 


InputStream is= null; 
try { 
is= new FileInputStream(getPreferencesFile()); 
setPreferences(new Properties(getPreferences())); 
getPreferences().load(is); 
} catch (IOException e) 1 
try 1 
if (is != null) 
is.close(); 
} catch (IOException e1) { 
} 


j 
循环 中 的 控制 变量 应 该 总 是 在 循环 语句 中 声明 ， 如 下 列 来 目 同一 
项 目的 绝妙 小 函数 所 示 。 
public int countTestCases() 1 
int count- 0; 
for (Test each : tests) 
count += each.countTestCases(); 


return count; 


} 

偶尔 ， 在 较 长 的 函数 中 ， 变 量 也 可 能 在 某 个 代码 块 顶 部 ， 或 在 循 
环 之 前 声明 。 你 可 以 在 以 下 搞 自 TestNG 中 一 个 长 函数 的 代码 片段 中 找 
到 类 似 的 变量 。 


for (XmlTest test : m_suite.getTests()) 1 

TestRunner tr = m runnerFactory.newTestRunnerc(this, test); 

tr.addListener(m textReporter); 

m testRunners.add(tr); 

invoker = tr.getInvoker(); 

for (ITestNGMethod m : tr.getBeforeSuiteMethods()) { 
beforeSuiteMethods.put(m.getMethod(), m); 

} 

for (ITestNGMethod m : tr.getAfterSuiteMethods()) { 
afterSuiteMethods.put(m.getMethod(), m); 

} 


实体 变量 应 该 在 类 的 顶部 声明 。 这 应 该 不 会 增加 变量 的 垂直 距 
房 ， 因 为 在 设计 民 好 的 类 中 ， 它 们 如 妥 不 是 被 该 类 的 所 有 方法 也 是 被 
大 多 数 方法 所 用 。 

天 于 实体 变量 应 该 放 在 哪里 ， 争 论 不 断 。 在 C++ 中 ， 通 常会 采用 所 
ia “By EI” (scissors rule) ， 所 有 实体 变量 都 放 在 底部 。 而 在 Java 
中 ， 惯 例 是 放 在 类 的 顶部 。 没 理由 去 遵循 其 他 惯例 。 重 点 是 在 谁 都 知 
道 的 地 方 声 明 实 体 变 量 。 大 家 都 应 该 知道 在 哪儿 能 看 到 这 些 声 明 © 

例如 JUnit 4.3.1 中 的 这 个 奇怪 情形 。 我 极力 删 减 了 这 个 类 ， 好 说 明 
问题 。 如 采 你 看 到 代码 清单 大 致 一 半 的 位 置 ， 会 看 到 在 那里 声明 了 两 


个 实体 变量 。 如 采 放 在 更 好 的 位 置 ， 它 们 束 会 更 明显 。 而 现在 ， 读 代 
码 者 只 能 在 无 意 中 看 到 这 些 声 明 (就 像 我 一 样 ) 。 


public class TestSuite implements Test { 


static public Test createTest(Class<? extends TestCase> theClass, 


String name) { 


} 
public static Constructor<? extends TestCase> 
getTestConstructor(Class<? extends TestCase> theClass) 


throws NoSuchMethodException { 


} 


public static Test warning(final String message) { 


} 
private static String exceptionToString(Throwable t) { 


} 

private String fName; 

private Vector<Test> fTests= new Vector<Test>(10); 
public TestSuite() { 

} 

public TestSuite(final Class<? extends TestCase> theClass) { 


} 


public TestSuite(Class<? extends TestCase> theClass, String name) { 


} 
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然 的 顺序 。 若 坚定 地 遵循 这 条 约定 ， 读 者 将 能 够 确信 和 函数 声明 总 会 在 
其 调用 后 很 快 出 现 。 以 源 自 FitNesse 的 代码 清单 5-5 为 例 。 注 意 顶 部 的 函 
数 是 如 何 调用 其 下 的 函数 ， 而 这 些 被 调用 的 函数 又 是 如 何 调 用 更 下 面 
的 函数 的 。 这 样 束 能 轻易 找到 被 调用 的 函数 ， 极 大 地 增强 了 整个 模块 
的 可 读 性 。 

代码 清单 5-5 WikiPageResponder.java 


public class WikiPageResponder implements SecureResponder { 


protected WikiPage page; 
protected PageData pageData; 
protected String pageTitle; 
protected Request request; 
protected PageCrawler crawler; 
public Response makeResponse(FitNesseContext context, Request 
request) 
throws Exception 1 
String pageName = getPageNameOrDefault(request, "FrontPage"); 
loadPage(pageName, context); 
if (page == null) 
return notFoundResponse(context, request); 
else 


return makePageResponse(context); 


private String getPageNameOrDefault(Request request, String 
defaultPageName) 
{ 
String pageName = request.getResource(); 
if (StringUtil.isBlank(pageName)) 
pageName = defaultPageName; 
return pageName; 
} 
protected void loadPage(String resource, FitNesseContext context) 
throws Exception { 
WikiPagePath path = PathParser.parse(resource); 
crawler = context.root.getPageCrawler(); 
crawler.setDeadEndStrategy(new VirtualEnabledPageCrawler()); 
page = crawler.getPage(context.root, path); 
if (page != null) 
pageData = page.getData(); 
} 
private Response notFoundResponse(FitNesseContext context, Request 
request) 
throws Exception { 
return new NotFoundResponder().makeResponse(context, request); 
} 
private SimpleResponse makePageResponse(FitNesseContext context) 
throws Exception { 
pageTitle = PathParser.render(crawler.getFullPath(page)); 
String html = makeHtml(context); 


SimpleResponse response = new SimpleResponse(); 


response.setMaxA ge(0); 
response.setContent(html); 
return response; 


} 


说 句 题 外 话 ， 以 上 代码 片段 也 是 把 常量 保持 在 恰当 级 别 的 好 例子 
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的 做 法 是 把 它 放 在 易于 找到 的 位 置 ， 然 后 再 传递 到 真实 使 用 的 位 置 。 


概念 相关 。 概 念 相 关 的 代码 应 该 放 到 一 起 。 相 关 性 越 强 ， 彼 此 之 
间 的 距离 就 该 越 短 。 

如 上 所 述 ， 相 关 性 应 建立 在 直接 依赖 的 基础 上 ， 如 函数 间 调 用 ， 
或 函数 使 用 某 个 变量 。 但 也 有 其 他 相关 性 的 可 能 。 相 关 性 可 能 来 目 于 
执行 相似 操作 的 一 组 函数 。 请 看 以 下 来 自 Junit 4.3.1 的 代码 片段 : 


public class Assert { 


static public void assertTrue(String message, boolean condition) { 

if (!condition) 
fail(message); 

} 

static public void assertTrue(boolean condition) { 
assert True(null, condition); 

} 

static public void assertFalse(String message, boolean condition) { 
assert True(message, !condition); 

} 

static public void assertFalse(boolean condition) { 
assertFalse(null, condition); 


} 


这 些 函 数 有 着 极 强 的 概念 相关 性 ， 因 为 他 们 拥有 共同 的 命名 模 
式 ， 执 行 同 一 基础 任务 的 不 同 变 种 。 互 相 调用 是 第 二 位 的 。 即 便 没 有 
互相 调用 ， 也 应 该 放 在 一 起 。 


5.2.5 垂直 顺序 


一 般 而 言 ， 我 们 想 自 上 向 下 展示 函数 调用 依赖 顺序 。 也 就是 说 ， 
被 调用 的 函数 应 该 放 在 执行 调用 的 函数 下 面 [2]。 这 样 就 建立 了 一 种 上 自 
顶 问 下 贯穿 兰 代 码 模块 的 民 好 信息 流 。 

像 报纸 文章 一 般 ， 我 们 指望 最 重要 的 概念 先 出 来 ， 指 望 以 包括 最 
少 细 区 的 方式 表述 它们 。 我 们 指望 后 层 细 世 最 后 出 来 。 这 样 ， 我 们 束 
能 扫 过 源 代 码 文 件 ， 目 最 前 面 的 几 个 函数 获知 要 和 旧 ， 而 不 至 于 沉 诗 到 


细 世 中 。 代 码 清单 5-5 就 是 如 此 组 织 的 。 或 许 ， 更 好 的 例子 是 代码 清单 
15-5， 及 代码 清单 3-7。 


一 行 代码 应 该 有 多 宽 ? 要 回答 这 个 问题 ， 来 看 看 典型 的 程序 中 代 
码 行 的 宽度 。 我 们 再 一 次 检验 7 个 不 同 项 目 。 图 5-2 展 示 了 这 7 个 项 目的 
代码 行 宽度 分 布 情况 。 其 中 展现 的 规律 性 令 人 印象 深刻 ，45 个 字符 左 
右 的 宽度 分 布 尤为 如 此 。 其 实 ，20~60 的 每 个 尺寸 ， 都 代表 全 部 代码 
行 数 的 1%。 也 就 是 总 共 40%! 或 许 其 余 30% 的 代码 行 短 于 10 个 字符 。 
记 住 ， 这 是 个 对 数 标尺 ， 所 以 图 中 长 于 80 个 字符 部 分 的 线性 下 降 在 实 
际 情 况 中 会 极其 可 观 。 程 序 员 们 显然 更 喜爱 短 代 码 行 。 
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图 5-2 Java 程 序 代 码 行 长 度 分 布 
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化 ， 而 且 我 也 并 不 反对 代码 行 长 度 达 到 100 个 字符 或 120 个 字符 。 再 多 
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我 一 向 遵 循 无 需 拖 动 滚动 条 到 右边 的 原则 。 但 近年 来 显示 器 越 来 
越 充 ， 而 年 轻 程 序 员 又 能 将 显示 字符 缩小 到 如 此 程度 ， 屏 幕 上 甚至 能 
容纳 200 个 字符 的 宽度 。 别 那么 做 。 我 个 人 的 上 限 是 120 个 字符 。 


5.3.1 水 平方 向 上 的 区 隔 与 靠近 


我 们 使 用 空格 字符 将 彼此 紧密 相关 的 事物 连接 到 一 起 ， 也 用 空格 
字符 把 相关 性 较 弱 的 事物 分 隔 开 。 请 看 以 下 函数 : 


private void measureLine(String line) { 


lineCount++; 
int lineSize = line.length(); 
totalChars += lineSize; 
lineWidthHistogram.addLine(lineSize, lineCount); 
recordWidestLine(lineSize); 
} 
我 在 赋值 操作 符 周 围 加 上 空格 字符 ， 以 此 达到 强调 目的 。 赋 值 语 
人 句 有 两 个 确定 而 重要 的 要 素 : 左边 和 右边 。 空 格 字 符 加 强 了 分 隔 歼 
Ho 


ATI, TRAP TEES IC TU Zt ZAI DNA o EAA ER ZA 
Z ROBBSBUEUBAX. WRT, WMA uiu ° RIE KZH H 
5FINSA Pa, TUES, ABBR EAT AR? 

空格 字符 的 另 一 种 用 法 是 强调 其 前 面 的 运算 符 。 

public class Quadratic { 


public static double root1(double a, double b, double c) 1 


double determinant = determinant(a, b, c); 
return (-b + Math.sqrt(determinant)) / (2*a); 
} 
public static double root2(int a, int b, int c) { 
double determinant = determinant(a, b, c); 
return (-b - Math.sqrt(determinant)) / (2*a); 
} 
private static double determinant(double a, double b, double c) { 


return b*b - 4*a*c; 


} 

看 看 这 些 等 式 读 起 来 多 和 舒服。 乘法 因子 之 间 没 加 空格 ， 因 为 它们 
具有 较 融 优先 级 。 加 减法 运算 项 之 间 用 空格 隔 开 ， 因 为 加 法 和 减法 优 
先 级 较 低 。 

不 垃 的 是 ， 多 数 代 码 格式 化 工具 都 会 注视 运算 符 优先 级 ， 从 头 到 
尾 采 用 同样 的 空格 方式 。 在 重新 格式 化 代码 后 ， 以 上 这 些微 妙 的 空格 
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5.3.2 水 平 对 齐 


当 我 还 是 个 汇编 语言 程序 员 时 [3]， 使 用 水 平 对 齐 来 强调 某 些 程序 
结构 。 开 始 用 C、C++ 编 码 ， 最 终 转 网 Java 后 ， 我 继续 尽力 对 齐 一 组 声 
明 中 的 变量 名 ， 或 一 组 赋值 语句 中 的 右 值 。 我 的 代码 看 起 来 大 概 是 这 
FE: 

public class FitNesseExpediter implements ResponseSender 

{ 


private Socket socket; 


private InputStream input; 


private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsing TimeLimit; 
private long requestProgress; 
private long requestParsing Deadline; 
private boolean hasError; 
public FitNesseExpediter(Socket S, 
FitNesseContext context) throws 
Exception 
{ 
this.context = context; 
socket = S; 
input = s.getInputStream(); 
output = s.getOutputStream(); 


requestParsing TimeLimit = 10000; 
} 

我 发 现 这 种 对 齐 方式 没什么 用 。 对 齐 ， 像 是 在 强调 不 重要 的 东 
西 ， 把 我 的 目光 从 真正 的 意义 上 拉 开 。 例 如 ， 在 上 面 的 声明 列表 中 ， 
你 会 从 上 到 下 阅读 变量 名 ， 而 忽视 了 它们 的 类 型 。 同 样 ， 在 赋值 语句 
代码 清单 中 ， 你 也 会 从 上 到 下 陪读 右 值 ， 而 对 赋值 运算 符 视 而 不 见 。 
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所 以 ， 我 最 终 放 弃 了 这 种 做 法 。 如 今 ， 我 更 喜欢 用 不 对 齐 的 声明 
和 赋值 ， 如 下 所 示 ， 因 为 它们 指出 了 重点 。 如 果 有 较 长 的 列表 需要 做 
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FitNesseExpediter 类 中 声明 列表 的 长 度 说 明 该 类 应 该 被 拆 分 了 。 
public class FitNesseExpediter implements ResponseSender 
{ 
private Socket socket; 
private InputStream input; 
private OutputStream output; 
private Request request; 
private Response response; 
private FitNesseContext context; 
protected long requestParsingTimeLimit; 
private long requestProgress; 
private long requestParsingDeadline; 
private boolean hasError; 
public FitNesseExpediter(Socket s, FitNesseContext context) throws 
Exception 
{ 
this.context = context; 
socket = s; 
input = s.getInputStream(); 
output = s.getOutputStream(); 
requestParsing TimeLimit = 10000; 


5.3.3 缩 进 


源 文 件 是 一 种 继承 结构 ， 而 不 是 一 种 大 纲 结构 。 其 中 的 信息 涉及 
整个 文件 、 文 件 中 每 个 类 、 类 中 的 方法 、 方 法 中 的 代码 块 ， 也 涉及 代 
码 块 中 的 代码 块 。 这 种 继承 结构 中 的 每 一 层级 都 圈 出 一 个 范围 ， 名 称 
可 以 在 其 中 声明 ， 而 声明 和 执行 语句 也 可 以 在 其 中 解释 。 

要 让 这 种 范围 式 继承 结构 可 见 ， 我 们 依 源 代码 行 在 继承 结构 中 的 
位 置 对 源 代 码 行 做 缩 进 处 理 。 在 文件 顶层 的 语句 ， 例 如 大 多 数 的 类 声 
明 ， 根 本 不 缩 进 。 类 中 的 方法 相对 该 类 缩 进 一 个 层级 。 方 法 的 实现 相 
对 方法 声明 缩 进 一 个 层级 。 代 码 块 的 实现 相对 于 其 容 紫 代码 块 缩 进 一 
个 层级 ， 以 此 类 推 。 

程序 员 相 当 依 赖 这 种 缩 进 模式 。 他 们 从 代码 行 左边 查看 自己 在 什 
么 范围 中 工作 。 这 让 他 们 能 快速 跳 过 与 当前 关注 的 情形 无 关 的 旋 围 ， 
例如 站 或 while 语 句 的 实现 之 类 。 他 们 的 眼光 扫 过 左边 ， 查 找 新 的 方法 声 
明 、 新 变量 ， 甚 至 新 类 。 没 有 缩 进 的 话 ， 程 序 就 会 变 得 无 法 阅读 。 

试看 以 下 在 语法 和 语义 上 等 价 的 两 个 程序 : 


public class FitNesseServer implements SocketServer { private 


FitNesseContext 


context; public FitNesseServer(FitNesseContext context) { this.context 


context; } public void serve(Socket s) { serve(s, 10000); } public void 

serve(Socket s, long requestTimeout) { try { FitNesseExpediter sender 
- new 

FitNesseExpediter(s, context); 

sender.setRequestParsingTimeLimit(requestTimeout); sender.start(); } 

catch(Exception e) 1 e.printStackTrace(); } } } 

public class FitNesseServer implements SocketServer { 


private FitNesseContext context; 


public FitNesseServer(FitNesseContext context) { 
this.context = context; 
} 
public void serve(Socket s) { 
serve(s, 10000); 
} 
public void serve(Socket s, long requestTimeout) { 
try { 
FitNesseExpediter sender = new FitNesseExpediter(s, context); 
sender.setRequestParsingTimeLimit(requestTimeout); 
sender.start(); 
} 
catch (Exception e) { 
e.printStackTrace(); 


一 一 
一 一 


你 能 很 快 地 洞悉 有 缩 进 的 那个 文件 的 结构 。 你 几乎 能 立即 就 辨别 
出 那些 变量 、 构 造 器 、 存 取 器 和 方法 。 只 需要 几 秒 钟 就 能 了 解 这 是 一 
个 套 接 字 的 简 音 前端 ， 其 中 包括 了 超时 设 定 。 而 未 缩 进 的 版 本 则 不 经 
过 一 番 折 腾 束 无 法 明白 。 

违反 缩 进 规 则 。 有 时 ， 会 仿 不 住 想 要 在 短小 的 让 语句 、while 循环 
或 小 函数 中 违反 缩 进 规则 。 一 旦 这 么 做 了 ， 我 多 数 时候 还 是 会 回头 加 
上 缩 进 。 这 样 束 避免 了 出 现 以 下 这 种 范围 层级 坟 塌 到 一 行 的 情况 : 

public class CommentWidget extends TextWidget 

{ 

public static final String REGEXP = "4#[/\r\n]*(?:(?:\r\n)|\n|\r)?"; 


public CommentWidget(ParentWidget parent, String text) 
{super(parent, text); ) 
public String render() throws Exception {return ""; | 
j 
我 更 喜欢 扩展 和 缩 进 范围 ， 殉 像 这 样 : 
public class CommentWidget extends TextWidget { 
public static final String REGEXP = "A#[/\r\n]*(?:(?:\r\n)|\n|\r)?"; 
public CommentWidget(ParentWidget parent, String text) { 
super(parent, text); 
} 
public String render() throws Exception { 


return  ; 


有 时 ，while 或 for 语 句 的 语句 体 为 宝 ， 如 下 所 示 “。 我 不 喜欢 这 种 结 
构 ， 尽 量 不 使 用 。 如 有 果 无 法 避免 ， 承 确保 空 犯 围 体 的 缩 进 ， 用 括号 包 
围 起 来 。 我 无 法 告诉 你 ， 我 曾经 多 少 次 被 静 静 安 坐 在 与 while 循环 语句 
同一 行 末 尾 的 分 号 所 欺骗 。 除 非 你 把 那个 分 号 放 到 男 一 行 再 加 以 缩 
进 ， 否 则 区 很 难看 到 它 。 

while (dis.read(buf, 0, readBufferSize) != -1) 


3 


5.4 | 


每 个 程序 员 都 有 目 己 喜欢 的 格式 规则 ， 但 如 有 果 在 一 个 团队 中 工 
E, WEMA T RIA] ° 

一 组 开发 者 应 当 认 同一 种 格式 风格 ， 每 个 成 员 部 应 该 采用 那 种 风 
格 。 我 们 想 要 让 软件 拥有 一 以 货 之 的 风格 。 我 们 不 想 让 它 显 得 是 由 一 
大 票 意见 相左 的 个 人 所 写成 。 


2002 年 启动 FitrNesse 项 目 时 ， 我 和 开发 团队 一 起 制订 了 一 套 编码 风 
格 。 这 只 伦 了 我 们 10 分 钟 时 间 。 我 们 决定 了 在 什么 地 方 放置 括号 ， 缩 
进 几 个 字符 ， 如 何 命 名 类 、 变 量 和 方法 ， 如 此 等 等 。 然 后 ， 我 们 把 这 
些 规则 编写 进 IDE 的 代码 格式 功能 ， 接 着 就 一 直 沿 用 。 这 些 规 则 并 非 全 
是 我 喜爱 的 ; 但 它们 是 团队 决定 了 的 规则 。 作 为 团队 一 员 ， 在 为 
FitNesse 项 目 编写 代码 时 ， 我 遭 循 这 些 规则 。 

记 住 ， 好 的 软件 系统 是 由 一 系列 读 起 来 不 错 的 代码 文件 组 成 的 。 
它们 需要 拥有 一 致 和 顺畅 的 风格 。 读 者 要 能 确信 ， 他 们 在 一 个 源 文件 


中 看 到 的 格式 风格 在 其 他 文件 中 也 是 同样 的 用 法 。 绝 对 不 要 用 各 种 不 
同 的 风格 来 编写 源 代 码 ， 这 样 会 增加 其 复杂 度 。 


5.5 BH 格式 规 见 


我 个 人 使 用 的 规则 相当 简单 ， 如 代码 清单 5-6 所 示 。 可 以 把 这 段 代 
码 看 作 是 展示 如 何 把 代码 写成 最 好 的 编码 标准 文档 的 范例 。 
代码 清单 5-6 CodeAnalyzerjava 


public class CodeAnalyzer implements JavaFileAnalysis { 


private int lineCount; 
private int maxLineWidth; 
private int widestLineNumber; 
private LineWidthHistogram lineWidthHistogram; 
private int totalChars; 
public CodeAnalyzer() 1 
lineWidthHistogram = new LineWidthHistogram(); 
} 
public static List<File> findJavaFiles(File parentDirectory) { 
List<File> files = new ArrayList<File>(); 
findJavaFiles(parentDirectory, files); 
return files; 
} 
private static void findJavaFiles(File parentDirectory, List<File> 
files) { 
for (File file : parentDirectory.listFiles()) { 
if (file.getName().endsWith(".java")) 


files.add(file); 
else if (file.isDirectory()) 
findJavaFiles(file, files); 


i 
public void analyzeFile(File javaFile) throws Exception { 
BufferedReader br = new BufferedReader(new 
FileReader(javaFile)); 
String line; 
while ((line = br.readLine()) != null) 
measureLine(line); 
} 
private void measureLine(String line) { 
lineCount++; 
int lineSize = line.length(); 
totalChars += lineSize; 
lineWidthHistogram.addLine(lineSize, lineCount); 
recordWidestLine(lineSize); 
} 
private void recordWidestLine(int lineSize) { 
if (lineSize > maxLineWidth) { 
maxLineWidth - lineSize; 


widestLineNumber - lineCount; 


j 
public int getLineCount() { 


return lineCount; 


} 
public int getMaxLineWidth() 1 
return maxLineWidth; 
} 
public int getWidestLineNumber() { 
return widestLineNumber; 
} 
public LineWidthHistogram getLineWidthHistogram() { 
return lineWidthHistogram; 
} 
public double getMeanLineWidth() { 
return (double) totalChars / lineCount; 
} 
public int getMedianLineWidth() { 
Integer[] sortedWidths = getSortedWidths(); 
int cumulativeLineCount = 0; 
for (int width : sortedWidths) { 
cumulativeLineCount += lineCountForWidth(width); 
if (cumulativeLineCount > lineCount / 2) 
return width; 
} 
throw new Error("Cannot get here"); 
} 
private int lineCountForWidth(int width) { 
return lineWidthHistogram.getLinesforWidth(width).size(); 
} 
private Integer] ] getSortedWidths() 1 


Set<Integer> widths = lineWidthHistogram.getWidths(); 
Integer[] sortedWidths = (widths.toArray(new Integer[0])); 
Arrays.sort(sortedWidths); 

return sortedWidths; 


URE: 方块 显示 平均 数 的 sigma/2 以 上 及 以 下 长 度 。 没 错 ， 我 知道 文 
件 长 度 分 布 不 太 寻 常 ， 所 以 标准 偏差 也 并 非 那 么 精确 。 不 过 在 此 并 不 
寻求 精确 ， 只 是 找 个 感觉 受 了 。 

[2]. 原 注 : Pascal 、C 和 C++ 等 语言 中 完全 不 同 ， 在 这 些 语言 中 ， 函 数 应 
该 在 被 调用 之 前 定义 ， 至 少 是 声明 。 

[3]. 原 注 : 开 什么 玩笑 ! 到 现在 我 仍 是 个 汇编 语言 程序 员 
旁边 赶 走 容易 ， 从 男孩 身边 把 铁 拿 走 可 难 ! 


[4]. 译 注 : 团队 规则 ， 原 文 team rules。 单 词 rule 在 这 里 有 两 个 意思 ， 一 
个 是 名 词 “ 规 则 ”*， 一 个 是 动词 “管辖 "， 所 以 本 证 标题 玩 了 个 文字 游戏 。 
中 文 不 易 翻 出 ， 故 采取 意译 加 注 。 


o 


把 男孩 从 铁 


将 变量 设置 为 私有 (private) 有 一 个 理由 : 我 们 不 想 其 他 人 依赖 这 
些 变量 。 我 们 还 想 在 心血 来 潮 时 能 自由 修改 其 类 型 或 实现 。 那 么 ， 为 
什么 还 是 有 那么 多 程序 员 给 对 象 自 动 添加 赋值 右 和 取 值 器 ， 将 私有 变 
量 公之于众 、 如 同 它 们 根本 就 是 公共 变量 一 般 呢 ? 


6.1 数据 抽象 


看 看 代码 清单 6-1 和 代码 清单 6-2 之 间 的 区 别 。 每 段 代码 都 表示 笛 卡 
儿 平面 上 的 一 个 点 。 不 过 ， 其 中 之 一 曝露 了 其 实现 ， 而 另 一 个 则 完全 
隐藏 了 其 实现 。 
代码 清单 6-1 具象 点 
public class Point { 
public double x; 
public double y; 
j 
代码 清单 6-2 抽象 点 
public interface Point { 
double getX(); 
double getY (); 
void setCartesian(double x, double y); 
double getR(); 
double getTheta(); 
void setPolar(double r, double theta); 
j 
代码 请 单 6-2 的 麻 亮 之 处 在 于 ， 你 不 知道 该 实现 会 是 在 矩形 坐标 系 
中 还 是 在 极 坐标 系 中 。 可 能 两 个 都 不 是 ! 然而 ， 该 接口 还 是 明白 无 误 
地 呈现 了 一 种 数据 结构 。 
不 过 它 呈 现 的 还 不 止 是 一 个 数据 结构 。 那 些 方法 固定 了 一 套 存 取 
策略 。 你 可 以 单独 读 取 某 个 坐标 ， 但 必须 通过 一 次 原子 操作 设 定 所 有 
坐标 。 


而 代码 清单 6-1 则 非常 清楚 地 是 在 矩形 坐标 系 中 实现 ， 并 要 求 我 们 
单个 操作 那些 坐标 。 这 就 曝露 了 实现 。 实 际 上 ， 即 便 变 量 都 是 私有 ， 
而 且 我 们 也 通过 变量 取 值 器 和 赋值 器 使 用 变量 ， 其 实现 仍然 曝露 了 。 

隐藏 实现 并 非 只 是 在 变量 之 间 放 上 一 个 函数 层 那 么 简单 。 隐 藏 实 
现 关 乎 抽象 ! 类 并 不 简单 地 用 取 值 器 和 赋值 器 将 其 变量 推 向 外 间 ， 而 
是 曝露 抽象 接口 ， 以 便 用 户 无 需 了 解数 据 的 实现 就 能 操作 数据 本 体 。 

看 看 代码 清单 6-3 和 代码 清单 6-4。 前 者 使 用 具象 手段 与 机 动车 的 燃 
料 层 通 信 ， 而 后 者 则 采用 百分比 抽象 。 你 能 确定 前 者 里 面 都 是 些 变 量 
存 取 器 ， 而 却 无 法 得 知 后 者 中 的 数据 形态 © 

代码 清单 6-3 具象 机 动车 


public interface Vehicle { 


double getFuelTankCapacityInGallons(); 
double getGallonsOfGasoline(); 
j 
代码 清单 6-4 抽象 机 动车 
public interface Vehicle { 
double getPercentFuelRemaining(); 
j 
以 上 两 段 代 码 以 后 者 为 佳 。 我 们 不 愿 曝 圳 数据 细节 ， 更 愿意 以 抽 
象形 态 表述 数据 。 这 并 不 只 是 用 接口 和 /或 赋值 器、 取 值 器 就 万 事 大 
吉 。 要 以 最 好 的 方式 呈现 某 个 对 象 包含 的 数据 ， 需 要 做 严肃 的 思考 。 
傻 乐 着 乱 加 取 值 右 和 赋值 右 ， 是 最 坏 的 选择 © 


0.2 " y S JEAN 


这 两 个 例子 展示 了 对 象 与 数据 结构 之 间 的 差异 。 对 象 把 数据 隐藏 
于 抽象 之 后 ， 曝 露 操 作 数 据 的 函数 。 数 据 结构 曝露 其 数据 ， 没 有 提供 
有 意义 的 函数 。 回 过 头 再 读 一 遍 。 留 意 这 两 种 定义 的 本 质 。 它 们 是 对 
立 的 。 这 种 差异 貌似 微小 ， 但 却 有 深远 的 舍 义 。 
例如 ， 代 码 清单 6-5 中 的 过 程式 代码 形状 范例 。Geometry 类 操作 三 
个 形状 类 。 形 状 类 都 是 简单 的 数据 结构 ， 没 有 任何 行为 。 所 有 行为 都 
在 Geometry 类 中 。 
代码 清单 6-5 过 程式 形状 代码 
public class Square { 
public Point topLeft; 
public double side; 
} 
public class Rectangle { 
public Point topLeft; 
public double height; 
public double width; 
} 
public class Circle { 
public Point center; 
public double radius; 
j 
public class Geometry 1 
public final double PI = 3.141592653589793; 
public double area(Object shape) throws NoSuchShapeException 
{ 
if (shape instanceof Square) { 


Square s = (Square)shape; 


return s.side * s.side; 

} 

else if (shape instanceof Rectangle) { 
Rectangle r = (Rectangle)shape; 
return r.height * r.width; 

} 

else if (shape instanceof Circle) { 
Circle c = (Circle)shape; 
return PI * c.radius * c.radius; 

} 

throw new NoSuchShapeException(); 


} 

MS Ate a B6 XJ le DIA, hee 
一 一 他 们 大 概 是 对 的 ， 不 过 这 种 嘲笑 并 不 完全 正确 。 想 想 看 ， 如 果 给 
Geometry 类 添加 一 个 primeter( ) 函 数 会 怎样 。 那 些 形 状 类 根本 不 会 因此 
而 受 影 响 ! 另 一 方面 ， 如 果 添 加 一 个 新 形状 ， 就 得 修改 Geometry 中 的 
所 有 函数 来 处 理 它 。 再 读 一 裔 代码 。 注 意 ， 这 两 种 情形 也 是 直接 对 立 
Hy © 

现在 来 看 看 代码 清单 6-6 中 的 面 同 对 象 方案 。 这 里 ，area( ) 方 法 是 
多 态 的 。 不 需要 有 Geometry 类 。 所 以 ， 如 果 添 加 一 个 新 形状 ， 现 有 的 
函数 一 个 也 不 会 受到 影响 ， 而 当 添 加 新 函数 时 所 有 的 形状 都 得 做 修改 
[1]! 

代码 清单 6-6 多 态 式 形状 


public class Square implements Shape { 


private Point topLeft; 


private double side; 


public double area() 1 


return side*side; 


} 
public class Rectangle implements Shape { 
private Point topLeft; 
private double height; 
private double width; 
public double area() { 
return height * width; 


} 
public class Circle implements Shape { 
private Point center; 
private double radius; 
public final double PI = 3.141592653589793; 
public double area() { 


return PI * radius * radius; 


} 

我 们 再 次 看 到 这 两 种 定义 的 本 质 ; 它们 是 截然 对 立 的 。 这 说 明了 
对 象 与 数据 结构 之 间 的 二 分 原理 : 

过 程式 代码 (使 用 数据 结构 的 代码 ) 便于 在 不 改动 既 有 数据 结构 
的 前 提 下 添加 新 函数 。 面 向 对 象 代码 便于 在 不 改动 既 有 函数 的 前 提 下 
SETA > 

有 反 过 来 讲 也 说 得 通 : 


过 程式 代码 难以 添加 新 数据 结构 ， 因 为 必须 修改 所 有 函数 。 面 向 
对 象 代码 难以 添加 新 函数 ， 因 为 必须 修改 所 有 类 。 

所 以 ， 对 于 面向 对 象 较 难 的 事 ， 对 于 过 程式 代码 却 较 容易 ， 反 之 
INR ! 

在 任何 一 个 复杂 系统 中 ， 都 会 有 需要 添加 新 数据 类 型 而 不 是 新 函 
数 的 时 候 。 这 时 ， 对 象 和 面向 对 象 束 比较 适合 。 男 一 方面 ， 也 会 有 想 
要 添加 新 钞 数 而 不 是 数据 类 型 的 时 候 。 在 这 种 情况 下 ， 过 程式 代码 和 
数据 结构 更 合适 。 


6.3 得 墨 忒 耳 律 


著名 的 得 墨 式 耳 律 (The Law of Demeter) [2] 认 为 ， 模 块 不 应 了 解 
它 所 操作 对 象 的 内 部 情形 。 如 上 方 所 见 ， 对 象 隐 藏 数据 ， 上 曝露 操作 。 
这 意味 着 对 象 不 应 通过 存 取 器 曝露 其 内 部 结构 ， 因 为 这 样 更 像 是 曝露 
而 非 隐 藏 其 内 部 结构 。 

更 准确 地 说 ， 得 墨 趟 耳 律 认为 ， 类 C 的 方法 f 只 应 该 调用 以 下 对 和 象 
的 方法 : 

C 

由 f 创 建 的 对 象 ; 

作为 参数 传递 给 {的 对 象 ; 

由 C 的 实体 变量 持 有 的 对 象 。 

方法 不 应 调用 由 任何 函数 返回 的 对 象 的 方法 。 换 言 之 ， 只 跟 朋 友 
谈话 ， 不 与 卫生 人 谈话 。 

下 列 代码 [3] 违 反 了 得 墨 忒 耳 律 (除了 违反 其 他 规则 之 外 ) ， 因 为 
它 调 用 了 getOptions( ) 返回 值 的 getScratchDir( ) MH, X: VÀ HH T 
getScratchDir( ) 返 回 值 的 getAbsolutePath( )77 7 © 


final String outputDir = 
ctxt.getOptions().getScratchDir().getAbsolutePath(); 


6.3.1 KER 


这 类 代码 常 被 称 作 火车 失事 ， 因 为 它 看 起 来 就 像 是 一 列 火车 。 这 
类 连 串 的 调用 通 利 被 认为 是 及 脏 的 风格 ， 应 该 避免 [G36]。 最 好 做 类 似 
如 下 的 切 分 : 

Options opts = ctxt.getOptions(); 

File scratchDir = opts.getScratchDir(); 

final String outputDir = scratchDir.getAbsolutePath(); 

LAB EG XB TRE UAE? 当然 ， 模 块 知 道 ctxt TRA 
含有 多 个 选项 ， 每 个 选项 中 都 有 一 个 临时 目录 ， 而 每 个 临时 目录 都 有 
一 个 绝对 路 径 。 对 于 一 个 函数 ， 这 些 知识 真 够 丰富 的 。 调 用 函数 懂得 
如 何在 一 大 堆 不 同 对 象 间 浏 览 。 


a 


A 
AER 


TREE RS EME N AE, ER ctxt ^ Options Fl ScratchDir 
是 对 象 还 是 数据 结构 。 如 果 是 对 象 ， 则 它们 的 内 部 结构 应 当 隐藏 而 不 


BE, MA RENE DATA RR Er TE o MUR ctxt ^ 
Options 和 ScratchDir 只 是 数据 结构 ， 没 有 任何 行为 ， 则 它们 目 然 会 曝露 
其 内 部 结构 ， 得 墨 式 耳 律 也 束 不 适用 了 。 

属性 访问 器 函数 的 使 用 把 问题 搞 复 杂 了 “。 如 有 果 像 下 面 这 样 写 代 
码 ， 我 们 大 概 避 不 会 提 及 对 得 墨 式 耳 律 的 违反 。 

final String outputDir = ctxt.options.scratchDir.absolutePath; 

WRB ta ZETA A el ERE FE, RADO, MOT RTA 
TU BE AVS FER, IN SAL ARAL ZA s PAT, ALERT 
准 其 至 要 求 最 简单 的 数据 结构 都 要 有 访问 器 和 改 值 器 。 


6.3.2 Bae 


这 种 混淆 有 时 会 不 笠 导 致 混合 结构 ， 一 半 是 对 象 ， 一 半 是 数据 结 
构 。 这 种 结构 拥有 执行 操作 的 函数 ， 也 有 公共 变量 或 公共 访问 器 及 改 
值 茵 。 无 论 出 于 起 样 的 初 囊 ， 公 共 访 问 右 及 改 值 占 都 把 私有 变量 公开 
化 ， 诱 导 外 部 函数 以 过 程式 程序 使 用 数据 结构 的 方式 使 用 这 些 变 量 
[4] ° 

此 类 混杂 增加 了 添加 新 函数 的 难度 ， 也 增加 了 添加 新 数据 结构 的 
难度 ， 两 面 不 讨好 。 应 避免 创造 这 种 结构 。 它 们 的 出 现 ， 展 示 了 一 种 
乱七八糟 的 设计 ， 其 作者 不 确定 一 一 或 者 更 粳米 ， 完 全 无 视 一 一 他 们 
征 否 需要 函数 或 类 型 的 保护 。 


6.3.3 隐藏 结构 


假使 ctxt、Options 和 ScratchDir 是 拥有 真实 行为 的 对 象 又 怎样 呢 ? 
由 于 对 象 应 隐藏 其 内 部 结构 ， 我 们 就 不 该 能 够 看 到 内 部 结构 。 这 样 一 
来 ， 如 何 才 能 取得 临时 目录 的 绝对 路 径 呢 ? 


ctxt.getAbsolutePathOfScratchDirectoryOption(); 


或 者 

ctx.getScratchDirectoryOption().getAbsolutePath() 

第 一 种 方案 可 能 导致 ctxt 对 象 中 方法 的 曝露 。 第 二 种 方案 是 在 假设 
getScratchDirectoryOption() 返 回 一 个 数据 结构 而 非 对 象 。 两 种 方案 感觉 
都 不 好 。 

如 有 果 ctxt 是 个 对 象 ， 就 应 该 要 求 它 做 点 什么 ， 不 该 要 求 它 给 出 内 部 
情形 。 那 我 们 为 何 还 要 得 到 临时 目 孙 的 绝对 路 径 呢 ? 我 们 要 它 做 什 
A? 来 看 看 同一 模块 (许多 行 之 后 ) 的 这 段 代码 : 


String outFile = outputDir + "/" + className.replace(’.’, /) + ".class"; 


FileOutputStream fout = new FileOutputStream(outFile); 

BufferedOutputStream bos = new BufferedOutputStream(fout); 

这 种 不 同 层级 细节 的 混杂 (G34]G36]) E GUB © Al ^ REAL ^ 
文件 扩展 名 和 File 对 象 不 该 如 此 随便 地 混杂 到 一 起 。 不 过 ， 撤 开 这 些 毛 
病 ， 我 们 发 现 ， 取 得 临时 目录 绝对 路 人 径 的 初衷 是 为 了 创建 指定 名 称 的 
临时 文件 。 

所 以 ， 直 接 让 ctxt 对 象 来 做 这 事 如 何 ? 

BufferedOutputStream bos = 
ctxt.createScratchFileStream(classFileName); 

这 下 看 起 来 像 是 个 对 象 做 的 事 了 ! ctxt 隐藏 了 其 内 部 结构 ， 防 止 当 
前 函数 因 浏 览 它 不 该 知道 的 对 象 而 违反 得 重 忒 耳 律 。 


6.4 XA 


最 为 精练 的 数据 结构 ， 是 一 个 只 有 公共 变量 、 没 有 函数 的 类 。 这 
种 数据 结构 有 了 时 被 称 为 数据 传送 对 象 ， 或 DTO (Data Transfer 
Objects) 。DTO 是 非常 有 用 的 结构 ， 尤 其 是 在 与 数据 库 通 信 、 或 解析 


套 接 字 传 递 的 消息 之 类 场景 中 。 在 应 用 程序 代码 里 一 系列 将 原始 数据 
转换 为 数据 库 的 翻译 过 程 中 ， 它 们 往往 是 排头 兵 。 

更 常见 的 是 如 代码 清单 6-7 所 示 的 “ 豆 ”(bean) 结构 。 豆 结构 拥有 
由 赋值 器 和 取 值 器 操作 的 私有 变量 。 对 豆 结构 的 半 封 装 会 让 某 些 OO 纯 
化 论 者 感觉 舒服 些 ， 不 过 通常 没有 其 他 好 处 。 

代码 清单 6-7 address.java 

public class Address { 


private String street; 
private String streetExtra; 
private String city; 
private String state; 
private String zip; 
public Address(String street, String streetExtra, 
String city, String state, String zip) { 
this.street = street; 
this.streetExtra = streetExtra; 
this.city = city; 
this.state = state; 
this.zip = zip; 
} 
public String getStreet() { 
return street; 
} 
public String getStreetExtra() { 
return streetExtra; 
} 
public String getCity() 1 


return city; 
} 
public String getState() { 
return state; 
} 
public String getZip() { 
return Zip; 
} 
} 
Active Record 
Active Record 是 一 种 特殊 的 DTO 形 式 。 它 们 是 拥有 公共 (或 可 豆 式 
访问 的 ) 变量 的 数据 结构 ， 但 通常 也 会 拥有 类 似 save 和 find 这 样 的 可 浏 
TJ; ik ° Active Record 一 般 是 对 数据 库 表 或 其 他 数据 源 的 直接 翻译 。 
我 们 不 幸 经 利 发 现 开发 者 往 这 类 数据 结构 中 塞 进 业 务 规则 方法 ， 
把 这 类 数据 结构 当成 对 象 来 用 。 这 是 不 智 的 行为 ， 因 为 它 导 致 了 数据 
结构 和 对 象 的 混杂 体 。 
当然 ， 解 决 方案 就 是 把 Active Record 当 做 数据 结构 ， 并 创建 包含 业 
务 规则 、 隐 藏 内 部 数据 (可 能 就 是 Active Record 的 实体 ) 的 独立 对 象 。 


6.5 小 结 


对 象 曝露 行为 ， 隐 藏 数据 。 便 于 添加 新 对 象 类 型 而 无 需 修 改 既 有 
行为 ， 同 时 也 难以 在 既 有 对 象 中 添加 新 行为 。 数 据 结构 曝露 数据 ， 没 
有 明显 的 行为 。 便 于 向 既 有 数据 结构 添加 新 行为 ， 同 时 也 难以 向 既 有 
函数 添加 新 数据 结构 。 


在 任何 系统 中 ， 我 们 有 时 会 希望 能 够 灵活 地 添加 新 数据 类 型 ， 所 
以 更 喜欢 在 这 部 分 使 用 对 象 。 另 外 一 些 时 候 ， 我 们 硕 望 能 灵活 地 添加 
新 行为 ， 这 时 我 们 更 喜欢 使 用 数据 类 型 和 过 程 。 优 秀 的 软件 开发 者 不 
市 成 见地 了 解 这 种 情形 ， 并 依据 手边 工作 的 性 质 选 择 其 中 一 种 手段 。 


6.6 文献 


[Refactoring]: Refactoring: Improving the Design of Existing Code, 
Martin Fowler et al., Addison-Wesley, 1999. 


[1]. 原 注 : 经 验 丰 富 的 面向 对 象 设 计 人 员 都 知道 一 些 方法 ， 例 如 ， 
VISITOR 模 式 ， 或 双 同 分 派 。 但 这 些 技法 也 有 成 本 ， 而 且 通 和 常 返 回 一 
种 过 程式 程序 的 结构 。 


[2]. 原 注 : http://en.wikipedia.org/wiki/Law_of_Demeter ° 
[3]. 原 注 : RE ApacheTEZE rp JA e 
[4]. 原 注 : Refactoring: Improving the Design of Existing Code (中 译 


版 《 重 构 改善 既 有 代码 的 设计 (中 文 版 ，》) 一 书 中 ， 有 时 把 这 种 情 
况 称 作 特性 依恋 (Feature Envy) 


TB 7 XR 错误 处 理 


Michael Feathers 


在 一 本 有 关 整 洁 代 码 的 书 中 ， 居 然 有 讨论 错误 处 理 的 章节 ， 看 起 
来 有 些 突 几 。 错 误 处 理 只 不 过 是 编程 时 必须 要 做 的 事 之 一 。 输 入 可 能 
出 现 异 常 ， 设 备 可 能 失效 。 人 简 言 之 ， 可 能 会 出 错 ， 当 错误 发 生 时 ， 程 
FIORA oi EER TES LIE ° 

然而 ， 应 该 弄 清楚 错误 处 理 与 整洁 代码 的 关系 。 许 多 程序 完全 由 
错误 处 理 所 占 据 。 所 谓 占据 ， 并 不 是 说 错误 处 理 就 是 全 部 。 我 的 意思 
征 几 乎 无 法 看 明日 代码 所 做 的 事 ， 因 为 到 处 都 是 姿 乱 的 错误 处 理 代 
码 。 错 误 处 理 很 重要 ， 但 如 采 它 搞 乱 了 代码 逻 错 ， 融 是 错误 的 做 法 。 


在 本 章 中 ， 我 将 概要 列 出 编写 既 整 洁 又 强 固 的 代码 一 一 雅致 地 处 
理 错误 代码 的 一 些 扩 巧 和 思路 。 


在 很 久 以 前 ， 许 多 语言 都 不 文 持 异常 。 这 些 语言 处 理 和 汇报 错误 
的 手段 都 有 限 。 你 要 么 设置 一 个 错误 标识 ， 要 么 返回 给 调用 者 检查 的 
错误 码 。 代 码 清 单 7-1 中 的 代码 展示 了 这 些 手 段 。 

代码 清单 7-1 DeviceController.java 


public class DeviceController { 


public void sendShutDown() { 
DeviceHandle handle = getHandle(DEV 1); 
// Check the state of the device 
if (handle != DeviceHandle.INVALID) 1 
// Save the device status to the record field 
retrieveDeviceRecord(handle); 
// If not suspended, shut down 
if (record.getStatus() != DEVICE SUSPENDED) { 
pauseDevice(handle); 
clearDeviceWorkQueue(handle); 
closeDevice(handle); 
} else { 
logger.log("Device suspended. Unable to shut down"); 
} 
} else { 


logger.log("Invalid handle for: " + DEV1.toString()); 


} 

这 类 手段 的 问题 在 于 ， 它 们 搞 乱 了 调用 者 代码 。 调 用 者 必须 在 调 
用 之 后 即刻 检查 错误 。 不 驿 的 是 ， 这 个 步 台 很 容易 补遗 起 。 所 以 ， 通 
到 错误 时 ， 最 好 抛 出 一 个 异常 。 调 用 代码 很 整洁， 其 逻辑 不 会 被 销 误 
处 理 搞 乱 。 

代码 清单 7-2 展 示 了 在 方法 中 中 到 错误 时 抛 出 异常 的 情形 。 

代码 清单 7-2 DeviceController.java (采用 异常 处 理 ) 


public class DeviceController { 


public void sendShutDown() { 
try 1 
try ToShutDown(); 
} catch (DeviceShutDownError e) { 


logger.log(e); 


} 
private void tryToShutDown() throws DeviceShutDownError { 
DeviceHandle handle = getHandle(DEV 1); 
DeviceRecord record = retrieveDeviceRecord(handle); 
pauseDevice(handle); 
clearDeviceWorkQueue(handle); 
closeDevice(handle); 


} 


private DeviceHandle getHandle(DeviceID id) { 


throw new DeviceShutDownError("Invalid handle for: " + 
id.toString()); 


} 

注意 这 段 代 码 整 洁 了 很 多 。 这 不 仅 关 乎 美观 。 这 段 代 码 更 好 ， 
为 之 前 纠结 的 两 个 元 素 设 备 关 闭 算 法 和 错 旋 处 理 现在 被 隔离 了 。 你 可 
以 查看 其 中 任 一 元 率 ， 分 别 理解 它 。 


7.2 先 写 Try-Catch-Finally 语 句 


异常 的 妙 处 之 一 是 ， 它 们 在 程序 中 定义 了 一 个 范围 。 执 行 try- 
catch-finally 语 句 中 try 部 分 的 代码 时 ， 你 是 在 表明 可 随时 取消 执行 ， 并 
在 catch 语 句 中 接续 。 

在 某 种 意义 上 ，try 代码 块 就 像 是 事务 。catch 代码 块 将 程序 维持 在 
一 种 持续 状态 ， 无 论 try 代 码 块 中 发 生 了 什么 均 如 此 。 所 以 ， 在 编写 可 
能 抛 出 异常 的 代码 时 ， 最 好 先 写 出 try-catch-finally 语 句 。 这 能 帮 你 定义 
代码 的 用 户 应 该 期 竺 什么 ， 无 论 try 代 码 块 中 执行 的 代码 出 什么 错 都 一 
样 。 

来 看 个 例子 。 我 们 要 编写 访问 某 个 文件 并 读 出 一 些 序 列 化 对 象 的 
代码 。 

完 写 一 个 蛙 元 测试 ， 其 中 显示 当 文 件 不 存在 时 将 得 到 一 个 异常 : 

@Test(expected = StorageException.class) 


public void retrieveSectionShouldThrowOnInvalidFileName() 1 
sectionStore.retrieveSection( "invalid - file"); 
} 
该 测试 驱动 我 们 创建 以 下 占 位 代码 : 
public List<RecordedGrip> retrieveSection(String sectionName) 1 
// dummy return until we have a real implementation 
return new ArrayList<RecordedGrip>(); 
} 
MARKT, BND EABSJRARZUIB EE o F, ENI 
码 ， 笑 试 访问 非法 文件 。 该 操作 抛 出 一 个 异 第 : 
public List<RecordedGrip> retrieveSection(String sectionName) 1 
try 1 
FileInputStream stream = new FileInputStream(sectionName) 
} catch (Exception e) 1 
throw new StorageException(" retrieval error", e); 
j 
return new ArrayList<RecordedGrip>(); 
} 
ORM BG T. DDR AA Is o OS, RITI 
T Bar ay De) RAE, HE FF GS FileInputStream*4 ie 28 E 
正 抛 出 的 异常 ， 即 FileNotFoundException: 


public List<RecordedGrip> retrieveSection(String sectionName) 1 


try 1 
FileInputStream stream = new FileInputStream(sectionName); 
stream.close(); 

} catch (FileNotFoundException e) { 


throw new StorageException("retrieval error", e); 


} 
return new ArrayList<RecordedGrip>(); 

} 

如 此 一 来 ， 我 们 束 用 try-catch 结 构 定 义 了 一 个 范围 ， 可 以 继续 用 调 
WIK (TDD) 方法 构建 镜 余 的 代码 逻辑 。 这 些 代 码 逻 辑 将 在 
FileInputStream 和 close 之 间 添 加 ， 装 作 一 切 正常 的 样子 。 

兰 斌 编写 强行 抛 出 异 澡 的 测试 ， 再 往 处 理 副 中 深 加 人 行为， 使 之 满 
足 测 试 要 求 。 结 果 就 是 你 要 先 构造 try 代 码 块 的 事务 范围 ， 而 且 也 会 帮 
助 你 维护 好 该 范围 的 事务 特征 。 


7.3 NA 


辩论 业已 结束 。 多 年 来 ，Java 程 序 员 们 一 直 在 争论 可 控 异 常 
(checked exception) 的 利 与 次 。Java 的 第 一 个 版 本 中 引入 可 控 导 常 
时 ， 看 似 一 个 极 好 的 点 子 。 每 个 方法 的 签名 都 列 出 它 可 能 传递 给 调用 
者 的 异常 。 而 且 ， 这 些 异常 就 是 方法 类 型 的 一 部 分 。 如 果 签 名 与 代码 
实际 所 做 之 事 不 符 ， 代 码 在 字面 上 就 无 法 编译 。 
那 时 ， 我 们 认为 可 控 异 常 是 个 绝妙 的 主意 ; 而 且 ， 它 也 有 所 神 
益 。 然 而 ， 现 在 已 经 很 清楚 ， 对 于 强 固 软件 的 生产 ， 它 并 非 必 需 。C# 
不 支持 可 控 异 常 。 尽 管 做 过 勇敢 的 尝试 ，C++ 最 后 也 不 支持 可 控 异 常 。 
Python 和 Ruby 同 样 如 此 。 不 过 ， 用 这 些 语言 也 有 可 能 写 出 强 固 的 软 
件 。 我 们 得 决定 一 一 的 确 如 此 一 一 可 控 异 常 是 否 值 回 票 价 。 
代价 是 什么 ? 可 控 异 常 的 代价 就 是 违反 开放 /闭合 原则 [1]。 如 果 你 
在 方法 中 抛 出 可 控 异 常 ， 而 catch 语 句 在 三 个 层级 之 上 ， 你 就 得 在 catch 
语句 和 抛 出 异常 处 之 间 的 每 个 方法 签名 中 声明 该 异常 。 这 意味 着 对 软 


件 中 较 低 层级 的 修改 ， 都 将 波及 较 高 层级 的 签名 。 修 改 好 的 模块 必须 
重新 构建 、 发 布 ， 即 便 它们 上 自身 所 关注 的 任何 东西 都 没 改动 过 。 

以 菏 个 大 型 系统 的 调用 层级 为 例 。 顶 端 画 数 调 用 它们 之 下 的 范 
数 ， 逐 级 同 下 。 假 设 某 个 位 于 最 底层 级 的 画 数 被 修改 为 抛 出 一 个 异 
常 。 如 果 该 异常 是 可 控 的 ， 则 函数 签名 就 要 添加 throw 子 句 。 这 意味 着 
每 个 调用 该 函数 的 函数 都 要 修改 ， 捕 获 痢 异常 ， 或 在 其 签名 中 添加 合 
适 的 throw 子 句 。 以 此 类 推 。 最 终 得 到 的 就 古 一 个 从 软件 最 的 闹 员 罕 到 
最 高 端的 修改 链 ! 封装 被 打破 了 ， 因 为 在 抛 出 路 径 中 的 每 个 函数 都 要 
BS fF RA RS ao MA A TE LER BETE POL Mh Sch H a 
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WARMERS BREE, WTR RAN Bea: 你 必 
须 捕获 异常 。 但 对 于 一 般 的 应 用 开发 ， 其 依赖 成 本 要 高 于 收益 。 


7.4 给 出 Æp ;} A 


(ab aE Ses, ABD Se EEA ZIA, MEABE R 
RIMAE ^ Java, (RE AMEME E EIRE (stack 
trace) ; 然而 ， 扒 栈 踩 迹 却 无 法 告诉 你 该 失败 操作 的 初衷 。 

应 创建 信息 充分 的 错误 消息 ， 并 和 异常 一 起 传递 出 去 。 在 消息 
中 ， 包 括 失败 的 操作 和 失败 类 型 。 如 有 果 你 的 应 用 程序 有 日 志 系 统 ， 传 
递 足 够 的 信息 给 catch 块 ， 并 记录 下 来 。 


对 错误 分 类 有 很 多 方式 。 可 以 依 其 来 产 分 类 : 十 来 目 组 件 还 是 其 
他 地 方 ? 或 依 其 类 型 分 类 : 是 设备 错误 、 网 络 错误 还 是 编程 错误 ? 不 
过 ， 当 我 们 在 应 用 程序 中 定义 异常 类 时 ， 最 重要 的 考虑 应 该 是 它们 如 
何 被 捕获 。 

来 看 一 个 不 太 好 的 异常 分 类 例子 。 下 面 的 try-catch-finally 语 句 是 对 
某 个 第 三 方 代 码 库 的 调用 。 它 履 兰 了 该 调用 可 能 抛 出 的 所 有 有 寞 各: 

ACMEPort port = new ACMEPort(12); 

try 1 

port.open(); 


} catch (DeviceResponseException e) 1 
reportPortError(e); 
logger.log(" Device response exception", e); 
} catch (ATM1212UnlockedException e) 1 
reportPortError(e); 
logger.log(" Unlock exception", e); 
} catch (GMXError e) 1 
reportPortError(e); 
logger.log("Device response exception"); 
} finally { 


} 

语句 包含 了 一 大 堆 重 复 代 码 ， 这 并 不 出 奇 。 在 大 多 数 异 第 处 理 
中 ， 不 管 真实 原因 如 何 ， 我 们 总 是 做 相对 标准 的 处 理 。 我 们 得 记录 错 
误 ， 确 保 能 继续 工作 。 

在 本 例 中 ， 既 然 知 道 我 们 所 做 的 事 不 外 如 此 ， 就 可 以 通过 打包 调 
用 API ` BR PRE ac EL ea A, MTT TR LINAS © 

LocalPort port = new LocalPort(12); 


try 1 
port.open(); 

) catch (PortDeviceFailure e) { 
reportError(e); 
logger.log(e.getMessage(), e); 

} finally { 


} 
LocalPort 类 就 是 个 简单 的 打包 类 ， 捕 获 并 翻译 由 ACMEPort 类 抛 出 
HF: 
public class LocalPort { 
private ACMEPort innerPort; 
public LocalPort(int portNumber) { 
innerPort = new ACMEPort(portNumber); 
} 
public void open() 1 
try 1 
innerPort.open(); 
} catch (DeviceResponseException e) { 
throw new PortDeviceFailure(e); 
} catch (ATM1212UnlockedException e) { 
throw new PortDeviceFailure(e); 
} catch (GM X Error e) 1 


throw new PortDeviceFailure(e); 


} 

类 似 我 们 为 ACMEPort 定 义 的 这 种 打包 类 非常 有 用 。 实 际 上 ， 将 第 
三 方 API 打 包 是 个 民 好 的 实践 手段 。 当 你 打包 一 个 第 三 方 API， 你 整 降 
低 了 对 它 的 依赖 ， 未 来 你 可 以 不 太 痛 否 地 改 用 其 他 代码 库 。 在 你 测试 
目 己 的 代码 时 ， 打 包 也 有 助 于 模拟 第 三 方 调用 。 

打包 的 好 处 还 在 于 你 不 必 绑 死 在 某 个 特定 厂商 的 API 设计 上 。 你 可 
以 定义 上 自己 感觉 舒服 的 API。 在 上 例 中 ， 我 们 为 port 设 备 错 误 定 义 了 一 
个 异 间 类型， 然后 发 现 这 样 能 写 出 更 整洁 的 代码 。 

对 于 代码 的 某 个 特定 区 域 ， 单 一 异 币 类 通 香 可 行 。 伴 随 异 单 发 送 
出 来 的 信息 能 够 区 分 不 同 错误 。 如 于 你 想 要 捕获 某 个 异 逢 ， 并 且 放 过 
Hi, BIE AAR > 
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而 ， 这 样 做 却 把 错误 检测 推 到 了 程序 的 边缘 地 带 。 你 打包 了 外 部 API 以 
抛 出 目 己 的 异常 ， 你 在 代码 的 顶端 定义 了 一 个 处 理 絮 来 应 付 任何 失败 
了 的 运算 。 在 大 多 数 时 候 ， 这 种 手段 很 榜 ， 不 过 有 时 你 也 许 不 愿 这 人 么 
做 。 

来 看 一 个 例子 。 下 面 的 兴 代 码 来 目 茶 个 记 账 应 用 的 开 文 总 计 模 
块 : 


try 1 


MealExpenses expenses - 


expenseReportDAO.getMeals(employee.getID()); 
m, total += expenses.getTotal(); 
} catch(MealExpensesNotFound e) 1 
m, total += getMealPerDiem(); 


e 


务 逻 辑 是 ， 如 果 消 耗 了 餐 食 ， 则 计 入 总 额 中 。 如 果 没 有 消耗 ， 
则 员工 得 到 当日 餐 食补 贴 。 有 异常 打 断 了 业务 逻辑 。 如 有 果 不 去 处 理 特 殊 
情况 会 不 会 好 一 些 ? 那样 的 话 代 码 看 起 来 会 更 简洁 。 吏 像 这 样 : 
MealExpenses expenses = 
expenseReportDAO.getMeals(employee.getID()); 


m total += expenses.getTotal(); 


BEERE IRE TRE EU? 能 。 可 以 修改 ExpenseReportDAO fé 
EE [E] MealExpenseXt& » AAA HE RITE, MRE T 3x BE 
BANALE MeaIExpenseAd&& < 


public class PerDiemMealExpenses implements MealExpenses { 


public int getTotal() { 


// return the per diem default 


这 种 手法 叫做 特例 模式 (SPECIAL CASE PATTERN , 
[Fowler] 。 创 建 一 个 类 或 配置 一 个 对 象 ， 用 来 处 理 特 例 。 你 来 处 理 特 
例 ， 客 户 代 码 就 不 用 应 付 异 常 行为 了 。 异 常 行为 被 封闭 到 特例 对 和 象 
中 o 


7.7 别 返 回 null 住 
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都 在 检查 null 值 的 应 用 程序 。 下 面 就 是 个 例子 : 
public void registerItem(Item item) { 
if (item != null) { 


ItemRegistry registry = peristentStore.getItemRegistry(); 
if (registry != null) { 

Item existing = registry.getItem(item.getID()); 

if (existing.getBillingPeriod().hasRetailOwner()) 1 


existing.register(item); 


j 

这 种 代码 看 似 不 坏 ， 其 实 糟 透 了 ! 返回 null 值 ， 基 本 上 是 在 给 自己 
增加 工作 量 ， 也 是 在 给 调用 者 添乱 。 只 要 有 一 处 没 检 查 nul 值 ， 应 用 程 
序 就 会 失控 。 

PERAZA, RA if 语句 的 第 二 行 没 有 检查 null 值 ? 如果 在 
运行 时 persistentStore 为 null 会 发 生 什么 事 ? 我 们 会 在 运行 时 得 到 一 个 
NullPointerException 异 常 ， 也 许 有 人 在 代码 顶端 捕获 这 个 异常 ， 也 可 能 
没有 捕获 。 两 种 情况 都 很 糟糕 。 对 于 从 应 用 程序 深 处 抛 出 的 
NullPointerExceptionzr 5 , KS JE TZ (ET xc INL ET 
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多 。 如 果 你 打算 在 方法 中 返回 null 值 ， 不 如 抛 出 异常 ， 或 是 返回 特例 对 
象 。 如 果 你 在 调用 某 个 第 三 方 API 中 可 能 返回 null 值 的 方法 ， 可 以 考虑 
用 新 方法 打包 这 个 方法 ， 在 新 方法 中 抛 出 异常 或 返回 特例 对 象 。 

在 许多 情况 下 ， 特 例 对 象 都 是 爽口 展 药 。 设 想 有 这 么 一 段 代 码 : 

List<Employee> employees = getEmployees(); 


if (employees !- null) { 

for(Employee e : employees) 1 

totalPay += e.getPay(); 

} 
} 
现在 ，getExployees 可 能 返回 nul， 但 是 否 一 定 要 这 么 做 呢 ? 如果 

修改 getEmployee， 返 回 空 列表 ， 束 能 使 代码 整洁 起 来 : 

List<Employee> employees = getEmployees(); 
for(Employee e : employees) { 

totalPay += e.getPay(); 


j 

PSE Java/7f Collections.emptyList( ) 方 法 ， 该 方法 返回 一 个 预定 义 不 
可 变 列 表 ， 可 用 于 这 种 目的 : 

public List<Employee> getEmployees() 1 

if( .. there are no employees .. ) 
return Collections.emptyList(); 

j 

这 样 编码 ， 职 能 尽量 避免 NulPointerException 的 出 现 ， 代 码 也 就 更 
整洁 了 。 


7.8 HE null 


EN TE A EnA E FRA BE, [EUR Pull P8 28 RC 77 1 9A 
BMH GR To BRAFAPIZEK (RAE fe Bnl, AVL BER n] Bee Fb 
nullf& ° 

举例 说 明 原 因 。 用 下 面 这 个 简单 的 方法 计算 两 点 的 投射 : 

public class MetricsCalculator 

{ 

public double xProjection(Point p1, Point p2) { 


return (p2.x — p1.x) * 1.5; 


} 

如 果 有 人 传 入 null 值 会 怎样 ? 
calculator.xProjection(null, new Point(12, 13)); 
当然 ， 我 们 会 得 到 一 个 NullPointerException 异 常 。 


如 何 修正 ? 可 以 创建 一 个 新 异常 类 型 并 抛 出 : 


public class MetricsCalculator 
public double xProjection(Point p1, Point p2) 1 


{ 
if (p1 == null || p2 == null) 1 
throw InvalidArgumentException( 
"Invalid argument for MetricsCalculator.xProjection"); 


} 

return (p2.x — p1.x) * 1.5; 

这 样 做 好 些 吗 ? 可 能 比 null 指 针 异 常 好 一 些 ， 但 要 记 住 ， 我 们 还 得 
中 。 这 个 处 理 器 该 做 什么 ? 


} 
H InvalidArgumentException 5: ff XE. X Ab FH gx 


还 有 更 好 的 做 法 吗 ? 
public class MetricsCalculator 


public double xProjection(Point p1, Point p2) 1 
assert p1 != null: "p1 should not be null"; 


assert p2 !- null : "p2 should not be null"; 


还 有 替代 方案 。 可 以 使 用 一 组 断言 : 


{ 


return (p2.x — p1.x) * 1.5; 


看 上 去 很 美 ， 但 仍 未 解决 问题 。 如 果 有 人 传 入 null 值 ， 还 是 会 得 到 
在 大 多 数 编程 语言 中 ， 没 有 良好 的 方法 能 对 付 由 调用 者 意外 传 入 
止 传 入 null 值 。 这 样 ， 你 在 编 


} 


运行 时 错误 。 
的 null 值 。 事 已 如 此 ， 恰 当 的 做 法 就 


码 的 时 候 ， 就 会 时 时 记 住 参 数列 表 中 的 null 值 意味 着 出 问题 了 ， 从 而 大 
量 避 免 这 种 无 心 之 失 。 


7.9 小 结 


整 冰 代码 是 可 读 的 ， 但 也 要 强 固 。 可 读 与 强 固 并 不 冲突 。 如 末 将 
错误 处 理 隔 离 看 待 ， 独 立 于 主要 逻辑 之 外 ， 束 能 写 出 强 固 而 整洁 的 代 
码 。 做 到 这 一 步 ， 我 们 就 能 单独 处 理 它 ， 也 极 大 地 提升 了 代码 的 可 维 
DE 
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我 们 很 少 控制 系统 中 的 全 部 软件 。 有 时 我 们 购买 第 三 方程 序 包 或 
使 用 开放 源 代 码 ， 有 时 我 们 依靠 公司 中 其 他 团队 打造 组 件 或 子 系统 。 


不 管 是 哪 种 情况 ， 我 们 部 得 将 外 来 代码 干净 利落 地 整合 进 目 己 的 代码 
中 。 本 章 将 介绍 一 些 保 持 软 件 边界 整洁 的 实践 手段 和 技巧 。 


8.1 = 


在 接口 提供 者 和 使 用 者 之 间 ， 存 在 与 生 俱 来 的 张力 。 第 三 方程 序 
包 和 框架 提供 者 退 求 普 适 性 ， 这 样 就 能 在 多 个 环境 中 工作 ， 吸 引 广泛 
的 用 户 。 而 使 用 者 则 想 要 集中 满足 特定 需求 的 接口 。 这 种 张力 会 导致 
系统 边界 上 出 现 问 题 。 

以 java.util.Map 为 例 。 如 你 在 表 8-1 中 所 见 ，Map 有 着 广阔 的 接口 和 
丰富 的 功能 。 当 然 ， 这 种 力量 和 灵活 性 很 有 用 ， 但 也 要 付出 代价 。 比 
如 ， 应 用 程序 可 能 构造 一 个 Map 对 象 并 传递 它 。 我 们 的 初 囊 可 能 是 Map 
对 象 的 所 有 接收 着 都 不 要 删除 映射 图 中 的 任何 东西 。 但 表 8-1 的 顶端 却 
正好 有 一 个 clear() 方 法 。Map 的 任何 使 用 着 都 能 请 除 映 射 铭 。 或 许 设 
计 惯 例 是 Map 中 只 能 保存 特定 的 类 型 ， 但 Map 并 不 会 可 靠 地 约束 存 于 其 
中 的 对 象 的 类 型 。 使 用 者 可 随意 往 Map 中 塞 入 任何 类 型 的 条 目 。 


clear() void - Map 

containsKey(Object key) boolean - Map 
containsValue(Object value) boolean - Map 
entrySet() Set - Map 

equals (Object o) boolean - Map 

get (Object key) Object - Map 

getClass() Class«? extends Object» - Object 
hashCode() int - Map 

isEmpty() boolean - Map 

keySet() Set - Map 

notify() void - Object 

notifyAll() void - Object 

put(Object key, Object value) Object - Map 
putAll(Map t) void - Map 

remove (Object key) Object - Map 

Size() int - Map 

toString() Strinq - Object 

values() Collection - Map 

wait() void - Object 

wait(long timeout) void - Object 

wait(long timeout, int nanos) void - Object 


图 8-1 Mop 类 的 方法 
如 果 你 的 应 用 程序 需要 一 个 包容 Sensor 类 对 象 的 Map 映 射 图 ， 大 概 


BEA: 


Map sensors = new HashMap(); 
当代 码 的 其 他 部 分 需要 访问 这 些 sensor， 就 会 有 这 行 代 码 : 


Sensor s = (Sensor)sensors.get(sensorld ); 


这 行 代 码 一 再 出 现 。 代 码 的 调用 端 承担 了 从 Map 中 取得 对 象 并 将 其 
转换 为 正确 类 型 的 职 贡 。 行 倒是 行 ， 却 并 非 整 汽 的 代码 。 而 且 ， 这 行 
代码 并 未 说 明 目 己 的 用 途 。 通 过 对 泛 型 的 使 用 ， 这 段 代 码 可 读 性 可 以 
大 大 提高 ， 如 下 所 示 : 


Map<Sensor> sensors = new HashMap<Sensor>(); 


Sensor s = sensors.get(sensorld ); 

不 过 ，Map<Sensor> 提 供 了 超出 所 需 / 所 愿 的 功能 的 问题 ， 仍 未 得 
到 解决 。 

在 系统 中 不 受 限制 地 传递 Map<Sensor> 的 实体 ， 意 味 着 当 到 Map 的 
接口 被 修改 时 ， 有 许多 地 方 都 要 跟着 改 。 你 或 许 会 认为 这 样 的 改动 不 
太 可 能 发 生 ， 不 过 ， 当 Java 5 加 入 对 泛 型 的 文 持 时 ， 的 确 发 生 了 改动 。 
我 们 也 的 确 见 到 一 些 系统 因为 要 做 大 量 改 动 才能 目 由 使 用 Map 类 ， 而 无 
法 使 用 泛 型 。 

使 用 Map 的 更 整洁 的 方式 大 致 如 下 。Sensors 的 用 户 不 必 天 心 是 否 
用 了 泛 型 ， 那 将 是 〈 也 该 是 ) 实现 细节 才 关心 的 。 

public class Sensors 1 

private Map sensors = new HashMap(); 

public Sensor getByld(String id) { 
return (Sensor) sensors. get(id); 

} 

/片段 

j 

边界 上 的 接口 (Map) 是 隐藏 的 。 它 能 随 来 自 应 用 程序 其 他 部 分 的 
极 小 的 有 影 啊 而 变动 。 对 泛 型 的 使 用 不 再 十 个 大 问题 ， 因 为 转换 和 类 型 
管理 是 在 Sensors 类 内 部 处 理 的 。 


该 接口 也 经 过 仔细 修整 和 归 置 以 适应 应 用 程序 的 需要 。 结 果 就 是 
得 到 易于 理解 、 难 以 被 误 用 的 代码 。Sensors 类 推动 了 设计 和 业务 的 规 
MI] © 

我 们 并 不 建议 总 是 以 这 种 方式 封装 Map 的 使 用 。 我 们 建议 不 要 将 
Map (或 在 边界 上 的 其 他 接口 ) 在 系统 中 传递 。 如 果 你 使 用 类 似 Map 这 
样 的 边界 接口 ， 束 把 它 保 留 在 类 或 近亲 类 中 。 扣 免 从 公共 API 中 返回 边 
界 接口 ， 或 将 边界 接口 作为 参数 传递 给 公共 API © 
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8.2 } > 


第 三 方 代 码 帮助 我 们 在 更 少时 间 内 发 布 更 丰富 的 功能 。 在 利用 第 
三 方程 序 包 时 ， 该 从 何 处 入 手 呢 ? 我 们 没有 测试 第 三 方 代 码 的 职责 ， 
但 为 要 使 用 的 第 三 方 代码 编写 测试 ， 可 能 最 符合 我 们 的 利益 。 

设想 第 三 方 代码 库 的 使 用 方法 并 不 清楚 。 我 们 可 能 会 化 上 一 两 天 

(或 者 更 多 ) 时 间 阅 读 文 档 ， 决 定 如 何 使 用 。 然 后 ， 我 们 会 编写 使 用 
第 三 方 代码 的 代码 ， 看 看 是 否 如 我 们 所 愿 地 工作 。 隐 入 长 时 间 的 调 
试 、 找 出 在 我 们 或 他 们 代码 中 的 缺陷 ， 这 可 不 是 什么 稀罕 事 。 

学 习 第 三 方 代码 很 难 。 整 合 第 三 方 代码 也 很 难 。 同 时 做 这 两 件 事 
难 上 加 难 。 如 有 果 我 们 采用 不 同 的 做 法 呢 ? 不 要 在 生产 代码 中 试验 新 东 
西 ， 而 是 编写 测试 来 和 遇 览 和 理解 第 三 方 代码 。Jim Newkirk 把 这 叫做 学 
习性 测试 (learning tests) 1。 

在 学 习性 测试 中 ， 我 们 如 在 应 用 中 那样 调用 第 三 方 代码 。 我 们 基 
本 上 是 在 通过 核对 试验 来 检测 自己 对 那个 API 的 理解 程度 。 测 试 聚 焦 于 
我 们 想 从 API 得 到 的 东西 。 


8.3 学 习 log4j 


比如 ， 我 们 想 使 用 apache log4j 包 来 代替 目 定 义 的 日 志 代 码 。 我 们 
下 载 了 log4j， 打 开 介 绍 文档 页 。 无 需 看 太 久 ， 就 编写 了 第 一 个 测试 用 
例 ， 硕 望 它 能 同 控 制 台 输 出 hello 了 字样。 

@Test 

public void testLogCreate() { 

Logger logger = Logger.getLogger("MyLogger"); 
logger.info("hello"); 

} 

运行 ，logger 发 生 了 一 个 错误 ， 告 诉 我 们 需要 用 Appender。 再 多 读 
一 点 文档 ， 我 们 发 现 有 个 ConsoleAppender。 于 是 我 们 创建 了 一 个 
ConsoleAppender， 再 看 是 否 能 解 开 癌 控 制 侣 输出 日 志 的 秘诀 。 

@Test 

public void testLogAddAppender() { 

Logger logger = Logger.getLogger("MyLogger"); 
ConsoleAppender appender = new ConsoleAppender(); 
logger.addAppender(appender); 

logger.info("hello"); 

} 

这 回 ， 我 们 发 现 Appender 没 有 输出 流 。 和 奇怪 ， 它 该 有 输出 流 的 。 
在 Google 上 得 到 一 点 帮助 后 ， 我 们 写 了 以 下 代码 : 

@Test 

public void testLogAddAppender() { 


Logger logger = Logger.getLogger(" MyLogger"); 
logger.removeAllAppenders(); 


logger.addAppender(new ConsoleAppender( 
new PatternLayout("%p 96t %m%n"), 
1 RYE: [BeckTDD], pp. 136-137 ° 
ConsoleAppender.S YSTEM_OUT)); 
logger.info("hello"); 

} 

这 回 行 了 ; hello 字样 的 日 志 信 息 出 现在 控制 台 上 ! 必须 告知 
ConsoleAppender， 主 它 往 探 制 台 写字 ， 看 起 来 有 点 奇怪 。 

很 有 趣 ， 当 我 们 移 除 ConsoleAppender.SystemOut 参 数 时 ， 那 个 
hello 字 样 仍然 输出 到 屏幕 上 。 但 如 果 取 走 PattemLayout， 束 会 出 现 关 于 
没有 输出 流 的 错误 信息 。 这 实在 太古 怪 了 。 

再 仔细 看 看 文档 ， 我 们 看 到 默认 的 ConsoleAppender 构造 右 是 “未 
配置 "的 ， 这 看 起 来 并 不 明显 或 没什么 用 ， 反 而 像 是 log4j 的 一 个 缺陷 ， 
或 者 至 少 是 前 后 不 太一 致 。 

再 搜索 、 阅 读 、 测 试 ， 最 终 我 们 得 到 代码 清单 8-1。 我 们 极 大 地 发 
据 了 log4j 的 工作 方式 ， 也 将 得 到 的 知识 融入 了 一 系列 位 单 的 单元 测试 
中 。 


代码 清单 8-1 LogTest.java 
public class LogTest { 
private Logger logger; 
@Before 
public void initialize() 1 
logger = Logger.getLogger("logger"); 
logger.removeAllAppenders(); 
Logger.getRootLogger().removeAllAppenders(); 
} 
@Test 


public void basicLogger() 1 
BasicConfigurator.configure(); 
logger.info("basicLogger"); 

} 

@Test 

public void addAppenderWithStream() { 

logger.addAppender(new Console Appender( 
new PatternLayout("%p %t %m%n"), 
ConsoleAppender.SYSTEM_OUT)); 

logger.info("addAppenderWithStream"); 

} 

@Test 

public void addAppenderWithoutStream() { 

logger.addAppender(new Console Appender( 
new PatternLayout("%p %t %m%n"))); 
logger.info("addAppenderWithoutStream"); 


} 
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知识 封装 到 目 己 的 日 志 类 中 ， 好 将 应 用 程序 的 其 他 部 分 与 1og4j 的 边界 
接口 隔离 开 来。 


8.4 学 习性 测试 毕 NAF 


学 习性 测试 毫 无 成 本 。 无 论 如 何 我 们 都 得 学 习 要 使 用 的 API， 而 纺 
写 测试 则 是 获得 这 些 知识 的 容易 而 不 会 影响 其 他 工作 的 途径 。 学 习性 


测试 是 一 种 精确 试验 ， 帮 助 我 们 增进 对 API 的 理解 。 

学 习性 测试 不 光 免 费 ， 还 在 投资 上 有 正面 的 回报 。 当 第 三 方程 序 
包 发 布 了 新 版 本 ， 我 们 可 以 运行 学 习性 测试 ， 看 看 程序 包 的 行为 有 没 
有 改变 。 

学 习性 测试 确保 第 三 方程 序 包 按照 我 们 想 要 的 方式 工作 。 一 旦 整 
合 进 来 ， 殊 不 能 保证 第 三 方 代码 总 与 我 们 的 需要 兼容 。 原 作者 不 得 不 
修改 代码 来 满足 他 们 目 己 的 新 需要 。 他 们 会 修正 缺陷、 添加 新 功 能 。 
风险 伴随 新 版 本 而 来 。 如 果 第 三 方程 序 包 的 修改 与 测试 不 兼容 ， 我 们 
也 能 马上 发 现 。 

无 论 你 是 否 需 要 通过 学 习性 测试 来 学 习 ， 总 要 有 一 系列 与 生产 代 
码 中 调用 方式 一 致 的 输出 测试 来 文 择 整 污 的 边界 。 不 使 用 这 些 边 界 测 
试 来 减轻 迁移 的 历 力 ， 我 们 可 能 会 超出 应 有 时 限 ， 长 久 地 绪 在 旧版 本 
上 面 。 


还 有 另 一 种 边界 ， 那 种 将 已 知 和 未 知 分 隔 开 的 边界 。 在 代码 中 总 
有 许多 地 方 是 我 们 的 知识 未 及 之 处 。 有 时， 边界 那 边 就 是 未 知 的 (至 
少 目前 未 知 ) 。 有 时 ， 我 们 并 不 往 边 界 那 边 看 过 去 。 

好 多 年 以 前 ， 我 曾 在 一 个 开发 无 线 通 信 系 统 软件 的 团队 中 工作 。 
该 系统 有 个 子 系统 Transmitter (XL) 。 我 们 对 Transmitter 知 之 其 
少 ， 而 该 子 系统 的 开发 者 还 没有 对 接口 进行 定义 。 我 们 不 想 受 这 种 事 
阻碍 ， 融 从 距 未 知 那 部 分 代码 很 远 处 开始 工作 © 

对 于 我 们 的 世界 如 何 结束 、 新 世界 如 何 开 始 ， 我 们 有 许多 好 主 
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界 那 边 的 视线 ， 我 们 还 是 从 工作 中 了 解 到 我 们 想 要 的 边界 接口 是 什么 
样 的 。 我 们 想 要 告知 发 送 机 一 些 事 : 

将 发 送 机 置 于 指定 频率 ， 并 发 出 目 这 个 流 得 到 的 数据 的 模拟 表 
Ro 

我 们 不 知 这 会 如 何 做 到 ， 因 为 API 还 没 设计 出 来 。 所 以 ， 我 们 决定 
过 后 再 编写 细节 代码 。 

为 了 不 受阻 碍 ， 我 们 定义 了 目 己 使 用 的 接口 。 我 们 给 它 取 了 个 好 
记 的 和 名字， 比如 Transmitter。 我们 给 它 写 了 个 名 为 transmit 的 方法 ， 获 
取 频 率 参 数 和 数据 闹 。 这 就 是 我 们 希望 得 到 的 接口 。 

编写 我 们 想得到 的 接口 ， 好 处 之 一 是 它 在 我 们 控制 之 下 。 这 有 助 
于 保持 客户 代码 更 可 读 ， 且 集中 于 它 该 完成 的 工作 。 

在 图 8-2 中 可 以 看 到 ， 我 们 将 CommunicationsController 类 从 发 送 器 
API (该 API 不 受 我 们 控制 ， 而 且 还 没 定 义 ) 中 隔离 出 来 。 通 过 使 用 符 
合 应 用 程序 的 接口 ，CommunicationsController 代 码 整 洁 且 足以 表达 其 
意图 。 一 旦 发 送 器 API 被 定义 出 来 ， 我 们 就 编写 TransmitterAdapter 来 跨 
接 。ADAPTER[I1] 封 装 了 与 API 的 互动 ， 也 提供 了 一 个 当 API 发 生变 动 
时 唯一 需要 改动 的 地 方 。 


<<interface>> 
通信 控制 器 Transmitter 
H 


*transmit (frequency, stream) 


Vs Ah BE Transmitter 
"— 


图 8-2 对 发 送 器 的 预测 


<<future>> 
Transmitter API 


这 套 设 计 方 案 为 测试 提供 了 一 种 极为 方便 的 接 颖 [2]。 使 用 适当 的 
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TransmitterAPI 时 ， 我 们 也 能 创建 确保 正确 使 用 API 的 边界 测试 。 


8.6 整洁 的 边界 


边界 上 会 发 生 有 趣 的 事 。 改 动 古 其 中 之 一 。 有 民 好 的 软件 设计 ， 
无 需 巨 大 投入 和 重 写 即 可 进行 修改 。 在 使 用 我 们 控制 不 了 的 代码 时 ， 
必须 加 倍 小 心 保护 投资 ， 确 保 未 来 的 修改 不 至 于 代价 太 大 。 

边界 上 的 代码 需要 清晰 的 分 割 和 定义 了 期 望 的 测试 。 应 该 避免 我 
们 的 代码 过 多 地 了 解 第 三 方 代码 中 的 特定 信息 。 依 靠 你 能 控制 的 东 
西 ， 好 过 依靠 你 控制 不 了 的 东西 ， 免 得 日 后 受 它 控制 。 

我 们 通过 代码 中 少数 几 处 引用 第 三 方 边界 接口 的 位 置 来 管理 第 三 
方 边界 。 可 以 像 我们 对 等 Map 那 样 包装 它们 ， 也 可 以 使 用 ADAPTER 模 
式 将 我 们 的 接口 转换 为 第 三 方 提供 的 接口 。 采 用 这 两 种 方式 ， 代 码 痢 
能 更 好 地 与 我 们 沟通 ， 在 边界 两 边 推动 内 部 一 致 的 用 法 ， 当 第 三 方 代 
码 有 改动 时 修改 点 也 会 更 少 。 
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再 弄 出 一 些 特殊 代码 来 测试 它们 。 通 常 这 会 是 种 简单 的 驱动 式 程序 ， 
让 我 们 能 够 手工 与 自己 编写 的 程序 交互 。 
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该 程序 是 个 简单 的 计时 器 ， 有 如 下 签名 : 

void Timer::ScheduleCommand(Command* theCommand, int 
milliseconds) 

想法 很 简单 ， 到达 指定 毫秒 数 时 ， 在 一 个 新 线程 中 执行 Command 
的 excute 方 法 。 问 题 在 于 如 何 测 试 它 。 

我 随便 写 了 个 简单 的 驱动 式 程序 ， 聆 听 来 目 键盘 的 动作 。 键 盘 输 
入 一 个 字符 时 ， 它 融 安 排 5 秒 钟 之 后 输出 同样 的 字符 。 我 输入 了 一 句 带 
节奏 的 歌词 ， 然 后 等 着 5 秒 钟 之 后 它 在 屏幕 上 重 现 出 来 。 

I... want-a-girl...just... like-the-girl-who-marr...ied...dear... 
old... dad.[1] 

在 按 下 那些 “.” 键 时 ， 我 真 的 在 呼 着 那 段 旋律 ， 当 那些 句点 出 现在 
屏幕 上 时 ， 我 又 再 呼 了 一 次 。 

那 瓯 是 我 的 测试 ! 我 看 到 这 法 子 可 行 ， 浇 示 给 同事 们 看 ， 然 后 就 
把 代码 扔 挥 了。 

如 前 文 所 述 ， 我 们 的 专业 领域 进步 其 多 。 如 今 ， 我 会 编写 测试 ， 
确保 代码 中 每 个 牺 角 各 元 都 如 我 所 愿 地 工作 。 我 会 将 代码 和 操作 系统 
隔离 开 ， 而 不 是 直接 调用 标准 计时 功能 。 我 会 仿造 一 套 计 时 函数 ， 这 
样 就 能 全 面 控 制 时 间 。 我 会 安排 一 些 设置 布尔 值 标识 的 命令 ， 往 前 步 
进 时 间 ， 查 看 这 些 标识 ， 确 你 它们 在 我 将 时 间 调 到 正确 值 时 由 false 变 
为 true。 

有 了 一 套 运 行 通过 的 测试 ， 我 会 确保 任何 需要 用 到 代码 的 人 都 能 
方便 地 使 用 这 些 测试 。 我 会 确保 测试 和 代码 一 起 签 入 同一 个 代码 包 。 

对 ， 我 们 进步 其 多 ; 但 还 有 很 长 的 路 要 走 。 敏 捷 和 TDD JAD RHE 
了 许多 程序 员 编 写 目 动 化 单元 测试 ， 每 天 还 有 更 多 人 加 入 这 个 行列 。 
但 是 ， 在 争先 如 后 将 测试 加 入 规程 中 时 ， 许 多 程序 员 遗 漏 了 一 些 关 于 
编写 好 测试 的 更 细微 但 却 重 要 的 要 点 。 


9.1 TDD 三 定律 


谁 都 知道 TDD 要 求 我 们 在 编写 生产 代码 前 先 编写 单元 测试 。 但 这 
条 规则 只 是 冰山 之 蜂 。 看 看 下 列 三 定律 [2]: 
定律 一 在 编写 不 能 通过 的 单元 测试 前 ， 不 可 编写 生产 代码 。 
定律 二 只 可 编写 刚好 无 法 通过 的 单元 测试 ， 不 能 编译 也 算 不 通 


过 


定律 三 只 可 编写 刚好 足以 通过 当前 失败 测试 的 生产 代码 。 
这 三 条 定律 将 你 限制 在 大 概 30 秒 一 个 的 循环 中 。 测 试 与 生产 代码 
一 起 编写 ， 测 试 只 比 生 产 代码 早 写 几 秒 钟 。 

这 样 写 程序 ， 我 们 每 天 就 会 编写 数 十 个 测试 ， 每 个 月 编写 数 百 个 
测试 ， 每 年 编写 数 干 个 测试 。 这 样 写 程序 ， 测 试 将 覆盖 所 有 生产 代 
码 。 测 试 代码 量 足 以 匹敌 生产 代码 量 ， 导 致 令 人 生长 的 管理 问题 。 
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几 年 前 ， 有 人 请 我 去 指导 一 个 开发 团队 。 那 个 团队 认定 ， 测 试 代 
码 的 维护 不 应 遵循 生产 代码 的 质量 标准 。 他 们 彼此 默许 在 单元 测试 中 
破坏 规矩 。“ 速 而 不 周 ” 成 了 团队 格言 。 变 量 命名 不 用 好 ， 测 斌 函数 不 
必 短 小 和 具有 摘 述 性 。 测 试 代码 不 必 做 展 好 设计 和 仔细 划分 。 只 要 测 
试 代 码 还 能 工作 ， 只 要 还 上 柳 亩 痢 生 产 代 码 ， 吏 足够 好 。 

有 些 读者 可 能 会 同意 这 种 做 法 。 或 许 ， 在 很 久 以 前 ， 你 也 用 过 我 
为 那个 Timer 类 写 测试 的 方法 。 从 编写 那 种 用 后 即 扔 的 测试 到 编写 全 佑 
目 动 化 单元 测试 是 一 大 进步 。 所 以 ， 束 像 那 个 我 指导 过 的 团队 一 样 ， 
你 或 许 也 会 认为 脏 测 试 好 过 没 测 试 。 


这 个 团队 没有 意识 到 的 是 ， 脏 测试 等 同 于 一 一 如 果 不 是 坏 于 的 话 
一 一 没 测 试 。 问 题 在 于 ， 测 试 必须 随 生 产 代 码 的 党 进而 修改 。 测 试 越 
脏 ， 束 越 难 修改 。 测 试 代码 越 缠 结 ， 你 就 越 有 可 能 人 花 更 多 时 间 塞 进 新 
测试 ， 而 不 是 编写 新 生产 代码 。 修 改 生产 代码 后 ， 旧 测试 就 会 开始 失 
败 ， 而 测试 代码 中 乱七八糟 的 东西 将 阻碍 代码 再 次 通过 。 于 征 ， 测 试 
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变 成 了 开发 者 最 大 的 抱怨 对 象 。 当 经 理 们 问 及 为 何 超支 如 此 巨大 ， 开 
发 着 们 束 归 和 省 于 测试 。 最 后 ， 他 们 只 能 扔 挥 了 整个 测试 代码 组 。 

但 是 ， 没 有 了 测试 代码 组 ， 他 们 就 失去 了 确保 对 代码 的 改动 能 如 
愿 工作 的 能 力 。 没 有 了 测试 代码 组 ， 他 们 惑 无 法 确保 对 系统 某 个 部 分 
的 修改 不 会 影响 到 系统 的 其 他 部 分 。 故 障 率 开始 增加 。 随 着 并 非 出 日 
有 意 的 故障 越 来 越 多 ， 他 们 开始 害怕 做 改动 。 他 们 不 再 清理 生产 代 
码 ， 因 为 他 们 害怕 修改 带 来 的 损害 多 于 收益 。 生 产 代码 开始 腐 坏 。 最 
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户 ， 还 有 对 测试 的 失望 。 

在 某 种 意义 上 ， 他 们 说 对 了 “。 测 试 的 确 让 他 们 失望 。 不 过 是 他 们 
目 己 决定 让 测 弃 变 得 乱七八糟 的 ， 而 那 正 是 失败 的 根源 。 如 有 果 他 们 保 
持 测 试 整洁 ， 测 试 束 不 会 令 他 们 失望 。 我 可 以 拍 着 胸 有 哺 这 么 说 ， 因 为 
我 曾经 参与 并 指导 了 多 个 凭借 整 涪 单元 测试 获得 成 功 的 团队 。 

故事 的 离间 很 简单 :测试 代码 和 生产 代码 一 样 重要 。 它 可 不 是 二 
等 公民 。 它 需要 被 思考 、 被 设计 和 被 照料 。 它 该 像 生 产 代码 一 般 保持 
Bu ° 

测试 市 来 一 切 好 处 

如 果 测 试 不 能 保持 整 涪 ， 你 束 会 失去 它们 。 没 有 了 测试 ， 你 束 会 
失去 祭 证 生产 代码 可 扩展 的 一 切 要 巡 。 你 没 看 错 。 正 是 单元 测试 让 你 
的 代码 可 扩展 、 可 维护 、 可 复 用 。 原 因 很 简单 。 有 了 测试 ， 你 束 不 担 


心 对 代码 的 修改 ! 没有 测试 ， 每 次 修改 都 可 能 市 来 缺陷 。 无 论 架构 多 
有 扩展 性 ， 无 论 设计 划分 得 有 多 好 ， 没 有 了 测试 ， 你 束 很 难 做 改动 ， 
因为 你 担忧 改动 会 引入 不 可 预知 的 缺陷 。 

有 了 测试 ， 释 云 一 扫 而 空 。 测 斌 覆盖 率 越 高 ， 你 束 越 不 担心 。 哪 
怕 是 对 于 那 种 架构 并 不 优秀 、 设 计 星 涩 纠缠 的 代码 ， 你 也 能 近乎 没有 
后 患 地 做 修改 。 实 际 上 ， 你 能 坚 无 顾虑 地 改进 架构 和 设计 ! AD, # 
次 了 生产 代码 的 目 动 化 单元 测试 程序 组 能 尽 可 能 地 保持 设计 和 架构 的 
整洁 。 测 试 市 来 了 一 切 好 处 ， 因 为 测试 使 改动 变 得 可 能 。 

如 果 测 试 不 干净 ， 你 改动 目 己 代码 的 能 力 束 有 所 牵制 ， 而 你 也 会 
开始 失去 改进 代码 结构 的 能 力 。 测 试 越 脏 ， 代 码 束 会 变 得 越 脏 。 最 
终 ， 你 丢失 了 测试 ， 代 码 开始 腐 坏 。 


整洁 的 测试 有 什么 要 素 ? 有 三 个 要 素 : 可 读 性 ， 可 读 性 和 可 读 
性 。 在 单元 测试 中 ， 可 读 性 甚至 比 在 生产 代码 中 还 重要 。 测 试 如 何 才 
能 做 到 可 读 ? 和 其 他 代码 中 一 样 : 明确 ， 和 容 洗 ， 还 有 足够 的 表达 力 。 
在 测试 中 ， 你 要 以 尽 可 能 少 的 文字 表达 大 量 内 容 。 

来 看 看 代码 清单 9-1 中 来 自 FitNesse 的 代码 。 这 三 个 测试 很 难 读 懂 ， 
显然 有 改 郑 空 间 。 首 先 ， 其 中 有 数量 念 怖 的 重复 代码 [G5] 调 用 addPage 
和 assertSubString。 更 重要 的 是 ， 代 人 码 中 充满 7 了 干扰 测试 表达 力 的 细 
节 。 

代码 清单 9-1 SerializedPageResponderTest.java 

public void testGetPageHieratchyAsXml() throws Exception 

{ 

crawler.addPage(root, PathParser.parse("PageOne")); 


crawler.addPage(root, PathParser.parse(" PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse(""PageTwo")); 
request.setResource("root"); 
request.addInput( type", "pages"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 

String xml = response.getContent(); 
assertEquals("text/xml", response.getContentType()); 
assertSubString("<name>PageOne</name>", xml); 
assertSubString("<name>PageTwo</name>", xml); 
assertSubString("<name>ChildOne</name>", xml); 

} 

public void 

testGetPageHieratchyAsXmlDoesntContainSymbolicLinks() 

throws Exception 

{ 
WikiPage pageOne = crawler.addPage(root, 

PathParser.parse("PageOne")); 
crawler.addPage(root, PathParser.parse("PageOne.ChildOne")); 
crawler.addPage(root, PathParser.parse("PageTwo")); 
PageData data = pageOne.getData(); 
WikiPageProperties properties = data.getProperties(); 
WikiPageProperty symLinks = 
properties.set(SymbolicPage.PROPERTY NAME); 

symLinks.set("SymPage", "PageTwo"); 


pageOne.commit(data); 
request.setResource("root"); 
request.addInput( type", "pages"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 
(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 

String xml = response.getContent(); 
assertEquals("text/xml", response.getContentType()); 
assertSubString("<name>PageOne</name>", xml); 
assertSubString("<name>PageTwo</name>", xml); 
assertSubString("<name>ChildOne</name>", xml); 
assertNotSubString("SymPage", xml); 

} 

public void testGetDataAsHtml() throws Exception 

{ 
crawler.addPage(root, PathParser.parse(  TestPageOne"), "test page"); 
request.setResource(" TestPageOne"); 
request.addInput(" type", "data"); 
Responder responder = new SerializedPageResponder(); 
SimpleResponse response = 

(SimpleResponse) responder.makeResponse( 
new FitNesseContext(root), request); 

String xml = response.getContent(); 
assertEquals("text/xml", response.getContentType()); 
assertSubString("test page", xml); 


assertSubString(" « Test", xml); 


} 

请 看 对 PathParser 的 那些 调用 。 它 们 将 字符 串 转 换 为 供 仆 虫 使 用 的 
PagePath 实 体 。 转 换 与 测试 早 无 关系， 徒然 混淆 了 代码 的 意图 。 与 创建 
responder 相 关 的 细节 ， 还 有 response 的 收集 与 转换 也 尽 是 噪声 。 此 外 还 
有 从 resource 和 参数 构造 请 求 URL 的 笨 手 段 。 〈 这 些 代 码 我 有 举人 参与 编 
写 ， 所 以 可 以 敞开 来 批评 。 ) 

最 终 ， 这 上段 代码 不 是 设计 来 给 人 看 的 。 可 怜 的 读者 淹没 在 细 市 的 
汪洋 大 海中 ， 在 真正 用 到 测试 之 前 ， 还 得 理解 这 HT © 

现在 看 看 代码 清单 9-2 中 改进 了 的 测试 。 这 些 测 斌 还 是 做 一 样 的 
事 ， 不 过 已 经 被 重 构 为 更 整 汽 和 有 表达 力 

代码 清单 9-2 SerializedPageResponderTest.java ( 重 构 后 ) 

public void testGetPageHierarchyAsXml() throws Exception 1 


makePages("PageOne", "PageOne.ChildOne", "PageTwo"); 


type:pages"); 
assertResponseIsX ML(); 


submitRequest("root", 


assertResponseContains( 
"<name>PageOne</name>",  "«name»PageTwoc/name»",  " 

<name>ChildOne</name>" 

); 
public void testSymbolicLinksAreNotInXmlPageHierarchy() throws 

Exception 1 

WikiPage page = makePage("PageOne"); 

makePages("PageOne.ChildOne", "PageTwo"); 

addLinkTo(page, "PageTwo", "SymPage"); 

submitRequest("root", "type:pages"); 

assertResponseIsXML.(); 


mm 


assertResponseContains( 
"<name>PageOne</name>",  "«name»PageTwoc/name»",  " 
<name>ChildOne</name>" 
); 
assertResponseDoesNotContain("SymPage"); 
} 
public void testGetDataAsXml() throws Exception { 
makePageWithContent("TestPageOne", "test page"); 
submitRequest("TestPageOne", "type:data"); 
assertResponseIsXML(); 
assertResponseContains(" test page", "<Test"); 
j 
这 些 测 试 显 然 呈现 了 构造 -操作 -检验 (BUILD-OPERATE- 
CHECK) [3] 模 式 。 每 个 测试 都 清晰 地 拆 分 为 三 个 环节 。 第 一 个 环 构 
造 测 斌 数据， 第 二 个 环节 操作 测试 数据 ， 第 三 个 部 分 检验 操作 是 否 得 
到 期 望 的 结 
注意， 那些 恼人 的 细 市 大 部 分 消失 了 。 测 试 直 达 目 的 ， 只 用 到 那 
些 真 正 需 要 的 数据 类 型 和 函数 。 读 测试 的 人 应 该 都 能 够 很 快 搞 清 楚 状 
况 ， 不 至 于 被 细节 误导 或 吓 倒 。 


代码 清单 9-2 中 的 测试 展示 了 为 测试 构造 一 种 面向 特定 领域 的 语言 
的 技巧 。 我 们 没有 直接 使 用 程序 员 用 来 对 系统 进行 操作 的 API， 而 是 打 
造 了 一 套 包 闭 这 些 API 的 函数 和 工具 代码 ， 这 样 惑 能 更 方便 地 编写 测 
试 ， 写 出 来 的 测试 也 更 便于 阅读 。 那 正 是 一 种 测试 语言 ， 可 以 帮助 程 
序 员 编 写 自己 的 测试 ， 也 可 以 帮助 后 来 者 阅读 测试 。 


这 种 测试 API 并 非 起 初 束 设计 出 来 ， 而 是 在 对 那些 充满 令 人 迷惑 细 
广 的 测试 代码 进行 后 续 重 构 时 逐渐 演进 。 如 同 你 看 见 我 将 代码 清单 9-1 
重 构 为 代码 清单 9-2 一 般 ， 守 规矩 的 开发 者 也 将 他 们 的 测试 代码 重 构 为 
更 位 涪 和 具有 表达 力 的 形式 。 


9.3.2 双重 标准 


在 某 种 意义 上 ， 本 章 开始 处 提 到 的 那个 团队 的 做 法 是 正确 的 。 测 
斌 API 中 的 代码 与 生产 代码 相 比 ， 的 确 有 一 套 不 同 的 工程 标准 。 测 试 代 
码 应 当 简 单 、 精 悍 、 足 具 表 达 力 ， 但 它 该 和 生产 代码 一 般 有 效 。 毕 竟 
它 是 在 测试 环境 而 非 生产 环境 中 和 运行， 这 两 种 环境 有 着 截然 不 同 的 需 
求 。 

请 看 代码 清单 9-3 中 的 测试 。 在 为 某 个 环境 控制 系统 设计 原型 时 ， 
我 写 了 这 个 测试 。 无 需 深 入 细节 ， 你 就 能 说 出 该 测试 在 “温度 太 低 ? 时 
检验 温度 警报 器 、 加 热 器 和 送 风机 是 否 全 部 打开 。 

代码 清单 9-3 EnvironmentControllerTest.java 

@Test 

public void turnOnLoTempAlarmAtThreashold() throws Exception { 
hw.setlemp(WAY TOO COLD); 


controller.tic(); 


assert True(hw.heaterState()); 
assert True(hw.blowerState()); 
assertFalse(hw.coolerState()); 
assertFalse(hw.hiTempAlarm()); 
assert True(hw.loTempA larm()); 


当然 ， 这 里 头 也 有 许多 细 季 。 例 如 ，tic 函 数 是 做 什么 的 ? 实际 
上 ， 在 读 测试 时 你 可 以 不 用 担心 这 些 问题 。 你 只 需 考虑 是 否 同意 系统 
最 终 状 态 是 否 与 “温度 太 低 ”的 情况 相符 。 
当 你 阅读 这 个 测试 时 ， 可 以 留意 到 上 自己 的 眼光 得 在 被 检验 的 状态 
的 名 称 与 状态 的 “意义 ”之 间 来 回 跳 转 。 你 看 到 heaterState， 有 眼光 辣 左 滑 
到 assertTrue。 你 看 到 coolerState， 有 眼光 同 左 看 assertFalse。 这 个 过 程 既 
乏味 又 不 可 靠 。 它 让 测试 变 得 难以 阅读 。 
我 大 幅 改 进 了 测试 的 可 读 性 ， 得 到 代码 清单 9-4。 
代码 清单 9-4 EnvironmentControllerTest.java ( 重 构 后 ) 
@Test 
public void turnOnLoTempAlarmAtThreshold() throws Exception { 
way TooCold(); 
assertEquals(" HBchL", hw.getState()); 
} 
当然 ， 我 创建 了 一 个 wayTooCold 函数 ， 隐 藏 了 tic 函数 的 细节 。 
不 过 要 注意 的 是 assertEquals 中 的 那个 奇怪 的 字符 串 。 大 写 表示 “ 打 
开 ”， 小 写 表示 “关闭 ”*， 那 些 字 符 遵 循 以 下 次 序 : (heater, blower, cooler, 
hi-temp-alarm, lo-temp-alarm} ° 
尽管 这 破坏 了 思维 映射 [4] 的 规划， 看 来 它 在 这 种 情况 下 还 是 适用 
的 。 只 要 你 明白 其 含义 ， 你 就 能 一 眼看 到 那个 字符 串 ， 迅 速 译 解 出 结 
果 。 
代码 清单 9-5 EnvironmentC ontroller Test.java ( 扩 展 到 更 大 范围 ) 
@Test 
public void turnOnCoolerAndBlowerlfTooHot() throws Exception { 
tooHot(); 
assertEquals("hBChl", hw.getState()); 


@Test 
public void tumOnHeaterAndBlowerIfTooCold() throws Exception { 


tooCold(); 
assertEquals("HBchl", hw.getState()); 

j 

@Test 

public void turnOnHiTempAlarmAtThreshold() throws Exception { 
way TooHot(); 
assertEquals( hBCHI", hw.getState()); 

} 

@Test 

public void turnOnLoTempAlarmAtThreshold() throws Exception { 
way TooCold(); 
assertEquals(" HBchL", hw.getState()); 

} 


代码 清单 9-6 中 给 出 了 getState 画 数 。 注 意 ， 代 码 效 率 不 是 非常 
高 。 要 提升 效率 ， 可 能 应 该 使 用 StringBuffer 。 
代码 清单 9-6 MockControlHardware.java 
public String getState() 1 
String state = ""; 
state += heater ? "H" : "h"; 
state += blower ? "B" : "b"; 
state += cooler ? "C" : "c"; 
state += hiTempAlarm ? "H" : "h"; 
state += loTempAlarm ? "L" : "]"; 


return state; 


StringBufferx 有 点 丑陋 。 即 便 在 生产 代码 中 ， 假 使 代价 较 小 ， 我 都 
会 避免 使 用 StringBuffer， 而 且 你 可 以 看 到 ， 清 单 9-6 中 代码 的 代价 的 确 
很 小 。 这 套 应 用 显然 是 舱 入 式 实时 系统 ， 计 算 机 和 内 存 资 源 都 很 有 
限 。 不 过 ， 测 试 环境 大 概 完 全 不 必 做 限制 。 

这 殉 是 双重 标准 。 有 些 事 你 大 概 永远 不 会 在 生产 环境 中 做 ， 而 在 
测试 环境 中 做 却 完全 没 问题 。 通 第 这 关乎 内 存 或 CPU 效 率 的 问题 ， 不 
过 却 永远 不 会 与 整 涪 有 关 。 


9.4 每 个 测试 一 个 断言 


有 个 流派 [3] 认 为 ，JUnit 中 每 个 测试 男 数 都 应 该 有 且 只 有 一 个 断言 
语句 。 这 条 规则 看 似 过 于 奇 求 ， 但 其 好 处 却 可 以 在 代码 清单 9-5 中 看 
到 。 这 些 测试 都 归结 为 一 个 可 快速 方便 地 理解 的 结论 。 

代码 清单 9-2 又 如 何 ? 我 们 能 将 关于 输出 是 XML 的 断言 与 输出 包含 
某 些 子 字 符 串 的 断言 轻易 地 组 合 到 一 起 ， 不 过 这 样 做 看 来 晕 无 道理 。 
然而 ， 我 们 可 以 将 测试 分 解 为 两 个 单独 的 测试 ， 每 个 都 有 目 己 的 断 
言 ， 如 代码 请 单 9-7 所 示 。 

代码 清单 9-7 SerializedPageResponderTest.java (单个 断言 的 版 
) 
public void testGetPageHierarchyAsXml() throws Exception 1 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 


a 


whenRequestIsIssued("root", "type:pages"); 
thenResponseShouldBeXML (); 
j 
public void testGetPageHierarchyHasRightTags() throws Exception 1 
givenPages("PageOne", "PageOne.ChildOne", "PageTwo"); 


whenRequestIsIssued(" root", "type:pages"); 
thenResponseShouldContain( 
"<name>PageOne</name>", "<name>PageTwo</name>", 
<name>ChildOne</name>" 
); 

} 

注意 ， 我 修改 了 那些 函数 的 名 称 ， 以 符合 given-when-then[6] 约 
定 。 这 让 测试 更 易 阅 读 。 不 幸 的 是 ， 如 此 分 解 测 试 ， 导 致 了 许多 重复 
代码 的 出 现 。 

可 以 利用 模板 方法 (TEMPLATE METHOD) [7] 模 式 ， 将 
given/when 部 分 放 到 基 类 中 ， 将 then 部 分 放 到 派生 类 中 ， 消 除 代 码 重 
复 问 题 。 或 者 ， 我 们 也 可 以 创建 一 个 完整 的 单独 测试 类 ， 把 given 和 
when 部 分 放 到 @Before 函 数 中 ， 把 when 部 分 放 到 每 个 @Test 函 数 中 。 但 
对 于 这 个 小 问题 ， 这 看 来 有 点 太 机 械 。 最 后 ， 我 还 是 保留 了 代码 清单 9- 
2 那 种 多 个 断言 的 形式 。 

我 认为 ， 单 个 断言 是 个 好 准则 [8]。 我 通 音 都 会 创建 文 持 这 条 准则 
的 特定 领域 测试 语言 ， 如 代码 清单 9-5 所 示 。 不 过 ， 我 也 不 害怕 在 单个 
测试 中 放 入 一 个 以 上 断言 。 我 认为 ， 最 好 的 说 法 是 单 个 测试 中 的 断言 
数量 应 该 最 小 化 。 

每 个 测试 一 个 概念 

更 好 一 些 的 规则 或 许 是 每 个 测试 函数 中 只 测试 一 个 概念 。 我 们 不 
想 要 超 长 的 测试 函数 ， 测 试 完 这 个 义 测 试 那个 。 代 码 清单 9-8 束 十 那 样 
一 种 测试 的 例子 。 这 个 测试 应 当 拆 解 为 3 个 单独 测试 ， 因 为 它 测试 了 3 
件 不 同 的 事 。 把 三 者 混 到 一 起 ， 读 者 束 不 得 不 猜想 每 段 代码 出 现 的 理 
由 ， 以 及 那 段 代码 到 瓜 要 测试 什么 。 

代码 清单 9-8 


/ 米 米 


* Miscellaneous tests for the addMonths() method. 
2 
public void testAddMonths() 1 
SerialDate d1 = SerialDate.createInstance(31, 5, 2004); 
SerialDate d2 = SerialDate.addMonths(1, d1); 
assertEquals(30, d2.getDayOfMonth()); 
assertEquals(6, d2.getMonth()); 
assertEquals(2004, d2.getY Y Y Y ()); 
SerialDate d3 = SerialDate.addMonths(2, d1); 
assertEquals(31, d3.getDayOfMonth()); 
assertEquals(7, d3.getMonth()); 
assertEquals(2004, d3.getY Y Y Y ()); 
SerialDate d4 = SerialDate.addMonths(1, SerialDate.addMonths(1, 
d1)); 
assertEquals(30, d4.getDayOfMonth()); 
assertEquals(7, d4.getMonth()); 
assertEquals(2004, d4.getY Y Y Y ()); 
j 
这 三 个 测试 函数 大 概 应 该 像 这 个 样子 : 
对 于 某 个 有 31 天 的 月 份 的 最 后 一 天 (如 五 月 ) : 
(1) 增加 一 个 该 月 份 最 末 一 天 为 30 日 (如 六 月 ) MAT, 日 期 
应 该 是 该 月 的 30 日 而 非 31 日 。 
(2) 增加 最 末 月 有 31 天 的 两 个 月 时 ， 日 期 应 该 是 31 日 。 
对 于 某 个 有 30 天 的 月 份 的 最 后 一 天 (如 六 月 ) : 
(3) 增加 一 个 有 31 天 的 月 份 时 ， 日 期 应 该 是 30 日 而 非 31 日 。 
这 样 一 来 ， 你 可 以 看 到 ， 在 这 些 混 洒 的 测试 当中 ， Sai 
遍 规 则 。 增 加 月 份 数 时 ， 日 期 不 能 大 于 该 月 份 的 最 末 一 天 。 这 意味 着 


在 2 月 28 日 增加 月 份 数 ， 就 会 得 到 3 月 28 日 。 而 这 个 测试 应 该 有 用 ， 但 
被 遗漏 了 。 

并 非 是 代码 清单 9-8 中 每 个 段落 的 多 重 断 言 导 致 问题 。 问 题 在 于 ， 
有 多 个 概念 被 测试 ， 所 以 ， 最 佳 规则 也 许 是 应 该 尽 可 能 减少 每 个 概念 
的 断言 数量 ， 每 个 测试 函数 只 测试 一 个 概念 。 


9.5 E.TI. R.S.T. 


[9] 

整洁 的 测试 还 遵循 以 下 5 条 规则 ， 这 5 条 规则 的 首 字 母 构 成 了 本 
标题 : 

快速 (Fast) 测试 应 该 够 快 。 测 试 应 该 能 快速 运行 。 测 试 运行 组 
慢 ， 你 就 不 会 想 要 频繁 地 运行 它 。 如 有 果 你 不 频繁 运行 测试 ， 就 不 能 尽 
早 发 现 问 题 ， 也 无 法 轻易 修正 ， 从 而 也 不 能 轻而易举 地 清理 代码 。 最 
A, (MERAH è 

独立 (Independent) 测试 应 该 相互 独立 。 某 个 测试 不 应 为 下 一 个 
测试 设 定 条 件 。 你 应 该 可 以 单独 运行 每 个 测试 ， 及 以 任何 顺序 运行 测 
试 。 当 测试 互相 依赖 时 ， 头 一 个 没 通 过 就 会 导致 一 连 捉 的 测试 失败 ， 
使 问题 诊断 变 得 困难 ， 隐 藏 了 下 级 错误 。 

可 重复 (Repeatable) 测试 应 当 可 在 任何 环境 中 重复 通过 。 你 应 该 
能 够 在 生产 环境 、 质 检 环 境 中 运行 测试 ， 也 能 够 在 无 网 络 的 列车 上 用 
笔记 本 电脑 运行 测试 。 如 果 测 试 不 能 在 任意 环境 中 重复 ， 你 就 总 会 
个 解释 其 失败 的 接口 。 当 环境 条 件 不 有 具备 时 ， 你 也 会 无 法 运行 测试 。 

自足 验证 (Self-Validating) 测试 应 该 有 布尔 值 输出 。 无 论 是 通过 
或 失败 ， 你 不 应 该 查看 日 志文 件 来 确认 测试 是 否 通过 。 你 不 应 该 手工 
对 比 两 个 不 同文 本 文件 来 确认 测试 是 否 通 过 。 如 果 测 试 不 能 目 足 验 


证 ， 对 失败 的 判断 就 会 变 得 依赖 主观 ， 而 运行 测试 也 需要 更 长 的 手工 
操作 时 间 。 

及 时 (Timely) 测试 应 及 时 编写 。 单 元 测试 应 该 恰好 在 使 其 通过 
的 生产 代码 之 前 编写 。 如 采 在 编写 生产 代码 之 后 编写 测试 ， 你 会 发 现 
生产 代码 难以 测试 。 你 可 能 会 认为 菏 些 生产 代码 本 吴 难 以 测试 。 你 可 
能 不 会 去 设计 可 测试 的 代码 。 


9.6 小 结 


我 们 只 是 触及 了 这 个 话题 的 表面 。 实 际 上 ， 我 认为 应 该 为 整洁 的 
测试 写 上 一 整 本 书 。 对 于 项 目的 健康 度 ， 测 试 盒 生 产 代 码 同等 重要 。 
或 许 测试 更 为 重要 ， 因 为 它 保证 和 增强 了 生产 代码 的 可 扩展 性 、 可 维 
护 性 和 可 复 用 性 。 所 以 ， 保 持 测 弃 整 洛 吧 。 让 测试 具有 表达 力 并 短小 
精 悍 。 发 明 作 为 面向 特定 领域 语言 的 测试 API， 帮 助 自己 编写 测试 。 

如 果 你 坐视 测试 腐 坏 ， 那 么 代码 也 会 跟着 腐 坏 。 你 持 测 试 整 涪 
吧 。 
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10m 类 


与 Jeff Langr 合 写 


本 书 到 目前 为 止 一 直 在 讨论 如 何 编写 民 好 的 代码 行 和 代码 块 。 我 
们 深入 研究 了 函 数 的 恰当 构成 ， 以 及 函数 之 间 如 何 互 相关 联 。 不 过 ， 
尽管 讨论 了 这 么 多 关于 代码 语句 及 由 代码 语句 构成 的 钞 数 的 表达 力 ， 
除非 我 们 将 注意 力 放 到 代码 组 织 的 更 高 层面 ， 就 始终 不 能 得 到 整洁 的 
代码 。 


10.1 类 的 组 织 


遵循 标准 的 Java 约 定 ， 类 应 该 从 一 组 变量 列表 开始 。 如 果 有 公共 静 
常量 ， 应 该 完 出 现 。 然 后 是 私有 议 态 变量 ， 以 及 私有 实体 变量 。 很 

少 会 有 公共 变量 。 
公共 函数 应 跟 在 变量 列表 之 后 。 我 们 喜欢 把 由 某 个 公共 函数 调用 
的 私有 工具 函数 紧 随 在 该 公共 函数 后 面 。 这 符合 了 目 顶 癌 下 原则 ， 让 
程序 读 起 来 束 像 一 篇 报纸 文章 。 

封装 

我 们 喜欢 保持 变量 和 工具 函数 的 私有 性 ， 但 并 不 执着 于 此 。 有 
时 ， 我 们 也 需要 用 到 受 护 (protected) 变量 或 工具 函数 ， 好 让 测试 可 以 
访问 到 。 对 我 们 来 说 ， 测 试 说 了 算 。 若 同一 程序 包 内 的 某 个 测试 需要 
调用 一 个 函数 或 变量 ， 我 们 吏 会 将 该 函数 或 变量 置 为 受 护 或 在 整个 程 
序 包 内 可 访问 。 然 而 ， 我 们 首先 会 想 办 法 使 之 保有 隐私 。 放 松 封 装 总 
是 下 策 。 


10.2 类 应 该 短小 


关于 类 的 第 一 条 规则 是 类 应 该 短小 。 第 二 条 规则 是 还 要 更 短小 。 
不 ， 我 们 并 不 是 要 重 弹 “函数 ”一 章 的 论调 。 就 像 画 数 一 样 ， 在 设计 类 
时 ， 首 要 规 条 就 是 要 更 短小 。 和 函数 一 样 ， 马 上 有 个 问题 出 现 ， 那 就 
是 “多 小 合适 呢 ? ” 

对 于 函数 ， 我 们 通过 计算 代码 行 数 衡量 大 小 。 对 于 类 ， 我 们 采用 
不 同 的 衡量 方法 ， 计 算 权 责 (responsibility) [1]。 


代码 清单 10-1 给 出 了 某 个 类 的 轮廓 。SuperDashboard 类 曝露 大 概 70 
个 公共 方法 。 大 多 数 开发 者 都 会 同意 ， 这 实在 是 太 长 了 。 有 些 开 发 者 
或 许 会 将 SuperDashboard 类 指 为 “ 神 的 类 ”。 
代码 清单 10-1 权 责 太 多 
public class  SuperDashboard extends JFrame implements 
MetaDataUser 
public String getCustomizerLanguagePath() 
public void setSystemConfigPath(String systemConfigPath) 
public String getSystemConfigDocument() 
public void setSystemConfigDocument(String 
systemConfigDocument) 
public boolean getGuruState() 
public boolean getNoviceState() 
public boolean getOpenSourceState() 
public void showObject(MetaObject object) 
public void showProgress(String s) 
public boolean isMetadataDirty() 
public void setIsMetadataDirty(boolean isMetadataDirty) 
public Component getLastFocusedComponent() 
public void setLastFocused(Component lastFocused) 
public void setMouseSelectState(boolean isMouseSelected) 
public boolean isMouseSelected() 
public LanguageManager getLanguageManager() 
public Project getProject() 
public Project getFirstProject() 
public Project getLastProject() 
public String getNewProjectName() 


public void setComponentSizes(Dimension dim) 

public String getCurrentDir() 

public void setCurrentDir(String newDir) 

public void updateStatus(int dotPos, int markPos) 

public Class[] getDataBaseClasses() 

public MetadataFeeder getMetadataFeeder() 

public void addProject(Project project) 

public boolean setCurrentProject(Project project) 

public boolean removeProject(Project project) 

public MetaProjectHeader getProgramMetadata() 

public void resetDashboard() 

public Project loadProject(String fileName, String projectName) 
public void setCanSaveMetadata(boolean canSave) 

public MetaObject getSelectedObject() 

public void deselectObjects() 

public void setProject(Project project) 

public void editorAction(String actionName, ActionEvent event) 
public void setMode(int mode) 

public FileManager getFileManager() 

public void setFileManager(FileManager fileManager) 

public ConfigManager getConfigManager() 

public void setConfigManager(ConfigManager configManager) 
public ClassLoader getClassLoader() 

public void setClassLoader(ClassLoader classLoader) 

public Properties getProps() 

public String getUserHome() 

public String getBaseDir() 


public int getMajorVersionNumber() 
public int getMinorVersionNumber() 
public int getBuildNumber() 
public MetaObject pasting( 
MetaObject target, MetaObject pasted, MetaProject project) 
public void processMenultems(MetaObject metaObject) 
public void processMenuSeparators( MetaObject metaObject) 
public void processTabPages(MetaObject metaObject) 
public void processPlacement(MetaObject object) 
public void processCreateLayout(MetaObject object) 
public void updateDisplayLayer(MetaObject object, int layerIndex) 
public void propertyEditedRepaint(MetaObject object) 
public void processDeleteObject(MetaObject object) 
public boolean getAttachedToDesigner() 
public void processProjectChangedState(boolean hasProjectChang) 
public void processObjectNameChanged(MetaObject object) 
public void runProject() 
public void setAcowDragging(boolean allowDragging) 
public boolean allowDragging() 
public boolean isCustomizing() 
public void setTitle(String title) 
public IdeMenuBar getIdeMenuBar() 
public void — showHelper(MetaObject ^ metaObject, String 
propertyName) 
// ... many non-public methods follow ... 
} 
如 果 SuperDashboard 类 只 包括 代码 清单 10-2 中 的 方法 呢 ? 


代码 清单 10-2 足够 短小 了 吗 ? 
public class  SuperDashboard extends JFrame implements 
MetaDataUser{ 
public Component getLastFocusedComponent() 
public void setLastFocused(Component lastFocused) 
public int getMajorVersionNumber() 
public int getMinorVersionNumber() 
public int getBuildNumber() 
} 
5 个 方法 不 算 多 ， 在 这 里 ， 虽 然 方法 数量 较 少 ， 可 SuperDashboard 
还 是 拥有 太 多 权 责 。 
类 的 名 称 应 当 描 述 其 权 责 。 实 际 上 ， 命 名 正 是 帮助 判断 类 的 长 度 
的 第 一 个 手段 。 如 果 无 法 为 某 个 类 命 以 精确 的 名 称 ， 这 个 类 大 概 就 太 
长 了 。 类 名 越 含混 ， 该 类 越 有 可 能 拥有 过 多 权 责 。 例 如 ， 如 采 类 名 中 
包括 含义 模糊 的 词 ， 如 Processor 或 Manager 或 Super， 这 种 现象 往往 说 明 
ADRES WM at RULE © 
我 们 也 应 该 能 够 用 大 概 25 个 单词 简要 描述 一 个 类 ， 且 不 用 “和 若 
(if) "^ “5 (and) "^ "zk (or) ”或 者 “但 (but) ”等 词汇 。 我 们 该 如 
何 描述 SuperDashboard 类 呢 ?“SuperDashboard 类 提供 了 对 最 后 拥有 焦 
点 的 组 件 的 访问 能 力 ， 我 们 还 能 通过 它 跟 踩 版 本 号 和 构建 序列 号 。” 
“还 能 ”二 字 正 好 提示 了 SuperDashboard 类 有 太 多 权 责 。 


10.2.1 单一 权 责 原则 


单一 权 责 原则 (SRP) [2] 认 为 ， 类 或 模块 应 有 且 只 有 一 条 加 以 修 
改 的 理由 。 该 原则 既 给 出 了 权 责 的 定义 ， 又 是 关于 类 的 长 度 的 指导 
针 。 类 只 应 有 一 个 权 责 一 一 只 有 一 条 修改 的 理由 。 


AREE 10-2 SLE) SuperDashboard 2/8 PI HON LUELLA RE 
由 。 首 先 ， 它 跟踪 大 概 会 随 软件 每 次 发 布 而 更 新 的 版 本 信息 。 第 二 ， 
它 管 理 Java Swing 组 件 (派生 上 自 JFrame， 顶 层 GUI 帘 口 的 Swing 表 现形 
AS) 。 每 次 修改 Swing 代 码 时 ， 无 疑 都 要 更 新 版 本 号 ， 但 反之 未 必 可 
行 : 也 可 能 依据 系统 中 其 他 代码 的 修改 而 更 新 版 本 信息 。 

鉴别 权 责 (修改 的 理由 ) 常常 帮助 我 们 在 代码 中 认识 到 并 创建 出 
更 好 的 抽象 。 可 以 轻易 地 将 全 部 三 个 处 理 版 本 信息 的 SuperDashboard 方 
法 拆 解 到 名 为 Version 的 类 中 (如 代码 清单 10-3 所 示 ) 。Version 类 是 个 
极 有 可 能 在 其 他 应 用 程序 中 得 到 复 用 的 构造 ! 

代码 清单 10-3 单一 权 责 类 


public class Version 1 


public int getMajorVersionNumber() 
public int getMinorVersionNumber() 
public int getBuildNumber() 
} 
SRP 是 00 设 计 中 最 为 重要 的 概念 之 一 ， 也 是 较为 容易 理解 和 遵循 
的 概念 之 一 。 奇 怪 的 是 SRP 往 往 也 是 最 容易 被 破坏 的 类 设计 原则 。 经 常 
DIRLA BNR o AT AVE 
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中 的 大 多 数 人 脑力 有 限 ， 只 能 更 多 地 把 精力 放 在 让 代码 能 工作 上 ， 而 
不 是 放 在 保持 代码 有 组 织 和 整洁 上 。 这 全 然 正确 。 分 而 治之 ， 其 在 编 
程 行为 中 的 重要 程度 等 同 于 在 程序 中 的 重要 程度 。 
问题 是 太 多 人 在 程序 能 工作 时 就 以 为 万 事 大 吉 了。 我 们 没 能 把 思 
维 转向 有 关 代 码 组 织 和 整洁 的 部 分 。 我 们 直接 转向 下 一 个 问题 ， 而 不 
征 回 头 将 腾 肿 的 类 切 分 为 只 有 单一 权 贡 的 去 耦 式 单元 。 
与 此 同时 ， 许 多 开发 者 害怕 数量 巨大 的 短小 单一 目的 类 会 导致 难 
以 一 目 了 然 抓 住 全 局 。 他 们 认为 ， 要 搞 消 楚 一 件 较 大 工作 如 何 完 成 ， 


就 得 在 类 与 类 之 间 找 来 找 去 。 

然而 ， 有 大 量 短小 类 的 系统 并 不 比 有 少量 庞大 类 的 系统 拥有 更 多 
移动 部 件 ， 其 效 量 大 致 相等 。 问 题写 : 你 是 想 把 工具 归 置 到 有 许多 抽 
ft felt FRATE Nic RIE TAR, DEM 
DBULTEGRE ETE PUR AR PATIRE P) t ? 

每 个 达到 一 定 规模 的 系统 都 会 包括 大 量 逻 辑 和 复杂 性 。 管 理 这 种 
复杂 性 的 首要 目标 吏 是 加 以 组 织 ， 以 便 开 发 者 知道 到 哪儿 能 找到 东 
西 ， 并 且 在 某 个 特定 时 间 只 需要 理解 直接 有 关 的 复杂 性 。 反 之 ， 拥 有 
巨大 、 多 目的 类 的 系统 ， 总 是 让 我 们 在 目前 并 不 需要 了 解 的 一 大 堆 东 
西 中 艰难 跋涉 。 

再 强调 一 下 : 系统 应 该 由 许多 短小 的 类 而 不 是 少量 巨大 的 类 组 
成 。 每 个 小 类 封 痛 一 个 权 责 ， 只 有 一 个 修改 的 原因 ， 并 与 少数 其 他 类 
一 起 协同 达成 期 望 的 系统 行为 。 


10.2.2 A 


类 应 该 只 有 少量 实体 变量 。 类 中 的 每 个 方法 都 应 该 操作 一 个 或 多 
个 这 种 变量 。 通 第 而 言 ， 方 法 操作 的 变量 越 多 ， 束 越 医 聚 到 类 上 。 如 
果 一 个 类 中 的 每 个 变量 都 被 每 个 方法 所 使 用 ， 则 该 类 具有 最 大 的 内 育 
性 。 

一 般 来 说 ， 创 建 这 种 极 大 化 内 聚 类 是 既 不 可 取 也 不 可 能 的 ， 男 一 
方面 ， 我 们 希望 内 素性 保持 在 较 高 位 置 。 内 聚 性 高 ， 意 味 着 类 中 的 方 
法 和 变量 互相 依赖 、 互 相 结合 成 一 个 逻辑 整体 。 

看 看 代码 浓 单 10-4 中 一 个 Stack 类 的 实现 方式 。 这 个 类 非常 内 聚 。 
在 三 个 方法 中 ， 只 有 size( ) 方 法 没有 使 用 所 有 两 个 变量 。 

代码 清单 10-4 Stack.java (一 个 内 聚 类 ) 

public class Stack 1 


private int topOfStack = 0; 
List<Integer> elements = new LinkedList<Integer>(); 
public int size() 1 
return topOfStack; 
} 
public void push(int element) { 
topOfStack++; 
elements.add(element); 
} 
public int pop() throws PoppedWhenEmpty 1 
if (topOfStack == 0) 
throw new PoppedWhenEmpty(); 
int element = elements.get(--topOfStack); 
elements.remove(topOfStack); 


return element; 


} 
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用 的 实体 变量 数量 增加 。 出 现 这 种 情况 时 ， 往 往 意味 着 至 少 有 一 个 类 
要 从 大 类 中 择 扎 出 来 。 你 应 当 笑 试 将 这 些 变 量 和 方法 分 拆 a 到 两 个 或 多 
个 类 中 ， 让 新 的 类 更 为 内 聚 。 


10.2.3 性 就 会 得 到 许多 短小 的 


仅仅 是 将 较 大 的 函数 切割 为 小 图 数 ， 吏 将 导致 更 多 的 类 出 现 。 想 
想 看 一 个 有 许多 变量 的 大 函数 。 你 想 把 该 男 数 中 有 某 一 小 部 分 拆 解 成 单 
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量 。 是 否 必 须 将 这 4 个 变量 都 作为 参数 传递 到 新 函数 中 去 呢 ? 

完全 没 必 要 ! 只 要 将 4 个 变量 提升 为 类 的 实体 变量 ， 完 全 无 需 传递 
任何 变量 就 能 拆 解 代码 了 。 应 该 很 容易 将 函数 拆 分 为 小 块 。 

可 惜 这 也 意味 着 类 起 失 了 内 聚 性 ， 因 为 堆积 了 越 来 越 多 只 为 允许 
少量 函数 共享 而 存在 的 实体 变量 。 等 一 下 ! 如 果 有 些 函 数 想 要 共享 某 
变量 ， 为 什么 不 让 它们 拥有 上 自己 的 类 呢 ? SHREASTARE, DIF 
E 


iN 
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所 以 ， 将 大 函数 拆 为 许多 小 函数 ， 往 往 也 是 将 类 拆 分 为 多 个 小 类 
的 时 机 。 程 序 会 更 加 有 组 织 ， 也 会 拥有 更 为 透明 的 结构 。 

为 了 说 明 我 的 意思 ， 不 如 从 Knuth 的 名 著 Literate Programming (中 
译 版 《字面 编程 》) [3] 中 摘 取 一 个 经 过 时 间 考 验 的 例子 。 代 码 清单 10- 
5 展示 了 Knuth 的 PrintPrimes 程 序 的 Java 版 本 。 为 示 公 平 ， 以 下 程序 并 非 
Knuth 原 版 ， 而 是 用 他 的 WEB 工 具 输 出 的 版 本 。 采 用 它 作 为 例子 的 目 
的 ， 是 因为 它 是 展示 如 何 将 较 大 的 函数 分 解 为 多 个 较 小 的 函数 和 类 的 
极 好 入 手 点 。 

代码 清单 10-5 PrintPrimes.java 


package literatePrimes; 


public class PrintPrimes { 
public static void main(String[] args) 1 

final int M = 1000; 
final int RR = 50; 
final int CC - 4; 
final int WW - 10; 
final int ORDMAX = 30; 
int P[] = new int[M + 1]; 
int PAGENUMBER; 


int PAGEOFFSET; 
int ROWOFFSET; 
int C; 
int J; 
int K; 
boolean JPRIME; 
int ORD; 
int SQUARE; 
int N; 
int MULTI] = new inti ORDMAX + 1]; 
J=1; 
K-71; 
P[1] = 2; 
ORD = 2; 
SQUARE = 9; 
while (K < M) { 
do { 
J=J+2; 
if (J == SQUARE) { 
ORD = ORD + 1; 
SQUARE = P[ORD] * P[ORD]; 
MULT[ORD - 1] = J; 
} 
N = 2; 
JPRIME = true; 
while (N < ORD && JPRIME) { 
while (MULTIN] < J) 


MULT[N] = MULT[N] + P[N] + PLN]; 
if (MULT[N] == J) 
JPRIME = false; 
N=N+1; 
} 
} while (!JPRIME); 
K=K+1; 
P[K] = J; 


PAGENUMBER = 1; 
PAGEOFFSET = 1; 
while (PAGEOFFSET <= M) { 
System.out.println("The First " + M + 
" Prime Numbers --- Page " + 
PAGENUMBER); 
System.out.println(""); 
for (ROWOFFSET = PAGEOFFSET; ROWOFFSET < 
PAGEOFFSET + RR; ROWOFFSET++){ 
for (C = 0; C < CC;C++) 
if (ROWOFFSET + C * RR <= M) 
System.out.format("%10d", PIROWOFESET + C * 
RRJ); 
System.out.println(""); 
} 
System.out.printIn("\f"); 
PAGENUMBER = PAGENUMBER + 1; 


PAGEOFFSET - PAGEOFFSET * RR * CC; 


} 
ARP HUS — TOKENTA, MARI * DIS IRRE , 
JU A BJ E Be AR BY AL. ^ BZD IIA ER AT 29 BT BU AY ER 
TW o 
从 代码 清单 10-6 到 代码 清单 10-8， 展 示 了 将 代码 清单 10-5 中 的 代码 
PRO ABU) ARAB, FAIRER ` BONE RNA FIAS 
Ho 
代码 清单 10-6 PrimePrinterjava ( 重 构 后 ) 
package literatePrimes; 
public class PrimePrinter { 
public static void main(String[] args) 1 
final int NUMBER OF PRIMES - 1000; 
int[] primes = PrimeGenerator.generat(:NUMBER, OF PRIMES); 
final int ROWS PER, PAGE - 50; 
final int COLUMNS PER, PAGE - 4; 
RowColumnPagePrinter tablePrinter = 
new RowColumnPagePrinter(ROWS_PER_PAGE, 
COLUMNS_PER_PAGE, 
"The First i 十 
NUMBER, OF PRIMES + 
" Prime Numbers"); 


tablePrinter.print(primes); 


} 
代码 清单 10-7 RowColumnPagePrinter.java 
package literatePrimes; 
import java.io.PrintStream; 
public class RowColumnPagePrinter { 
private int rowsPerPage; 
private int columnsPerPage; 
private int numbersPerPage; 
private String pageHeader; 
private PrintStream printStream; 
public RowColumnPagePrinter(int rowsPerPage, 
int columnsPerPage, 
String pageHeader) { 
this.rowsPerPage - rowsPerPage; 
this.columnsPerPage = columnsPerPage; 
this.pageHeader = pageHeader; 
numbersPerPage = rowsPerPage * columnsPerPage; 
printStream = System.out; 
} 
public void print(int data[]) 1 
int pageNumber = 1; 
for (int firstIndexOnPage = 0; 
firstIndexOnPage < data.length; 
firstIndexOnPage += numbersPerPage) { 
int lastIndexOnPage = 
Math.min(firstIndexOnPage + numbersPerPage - 1, 
data.length - 1); 


printPageHeader(pageHeader, pageNumber); 
printPage(firstIndexOnPage, lastIndexOnPage, data); 
printStream.println("\f"); 


pageNumber++; 


} 
private void printPage(int firstIndexOnPage, 
int lastIndexOnPage, 
int[] data) { 
int firstindexOfLastRowOnPage = 
firstIndexOnPage + rowsPerPage - 1; 
for (int firstIndexInRow = firstIndexOnPage; 
firstIndexInRow <= firstIndexOfLastRowOnPage; 
firstIndexInRow++) { 
printRow(firstIndexInRow, lastIndexOnPage, data); 


printStream.println(""); 


} 
private void printRow(int firstIndexInRow, 
int lastIndexOnPage, 
int[] data) { 
for (int column = 0; column < columnsPerPage; column++) { 
int index = firstIndexInRow + column * rowsPerPage; 
if (index <= lastIndexOnPage) 
printStream.format("%10d", data[index]); 


private void printPageHeader(String pageHeader, 
int pageNumber) { 
printStream.println(pageHeader + " --- Page " + pageNumber); 
printStream.println(""); 
j 
public void setOutput(PrintStream printStream) { 


this.printStream = printStream; 


} 
代码 清单 10-8 PrimeGenerator.java 
package literatePrimes; 
import java.util.ArrayList; 
public class PrimeGenerator 1 
private static int[] primes; 
private static ArrayList<Integer> multiplesOfPrimeFactors; 
protected static int[] generate(int n) { 
primes = new int[n]; 
multiplesOfPrimeFactors = new ArrayList<Integer>(); 
set2AsFirstPrime(); 
checkOddNumbersForSubsequentPrimes(); 
return primes; 
} 
private static void set2AsFirstPrime() { 
primes[0] = 2; 
multiplesOfPrimeFactors.add(2); 
} 


private static void checkOddNumbersForSubsequentPrimes() { 


int primeIndex = 1; 

for (int candidate = 3; 
primeIndex « primes.length; 
candidate += 2) { 

if (isPrime(candidate)) 


primes[primeIndex++] = candidate; 


} 
private static boolean isPrime(int candidate) { 


if (isLeastRelevantMultipleOfNextLargerPrimeFactor(candidate)) 


multiplesOfPrimeFactors.add(candidate); 
return false; 
} 
return isNotMultipleOfAnyPreviousPrimeFactor(candidate); 
} 
private static boolean 
isLeastRelevantMultipleOfNextLargerPrimeFactor(int candidate) { 
int nextLargerPrimeFactor = 
primes[multiplesOfPrimeFactors.size()]; 
int leastRelevantMultiple = mnextLargerPrimeFactor * 
nextLargerPrimeFactor; 
return candidate == leastRelevantMultiple; 
} 
private static boolean 
isNotMultipleOfAnyPreviousPrimeFactor(int candidate) { 


for (int n = 1; n < multiplesOfPrimeFactors.size(); n++) { 


if (isMultipleOfNthPrimeFactor(candidate, n)) 
return false; 
} 
return true; 
} 
private static boolean 
isMultipleOfNthPrimeFactor(int candidate, int n) { 
return 
candidate == 
smallestOddNthMultipleNotLessThanCandidate(candidate, n); 
} 
private static int 


smallestOddNthMultipleNotLessThanCandidate(int candidate, int n) 


int multiple = multiplesOfPrimeFactors.get(n); 
while (multiple « candidate) 

multiple += 2 * primes[n]; 
multiplesOfPrimeFactors.set(n, multiple); 


return multiple; 


) 

你 可 能 注意 到 的 第 一 件 事 就 是 程序 比 原 来 长 了 许多 ， 从 1 页 多 增加 
到 了 将 近 3 页 。 这 有 几 个 原因 。 其 一 ， 重 构 后 的 程序 采用 了 更 长 、 更 有 
搞 述 性 的 变量 名 。 其 二 ， EMA 后 的 程序 将 函数 和 类 声明 当 作 是 给 代码 
添加 注释 的 一 种 手段 。 其 三 ， 我 们 采用 了 空格 和 格式 技巧 让 程序 更 可 


E 


留意 程序 是 如 何 被 拆 分 为 3 个 主要 权 责 的 。PrimePrinter 类 中 只 有 主 
程序 。 主 程序 的 权 责 是 处 理 执行 环境 。 如 果 调 用 方式 改变 ， 它 也 会 随 
之 改变 。 例 如 ， 如 果 程 序 被 转换 为 SOAP 服 务 ， 则 该 类 也 会 被 影响 到 。 

RowColumnPagePrinter 类 懂得 如 何 将 数字 列表 格式 化 到 有 着 固定 
行 、 列 数 的 页 面 上 。 知 输出 格式 需要 改动 ， 则 该 类 也 会 被 影响 到 。 

PrimeGenerator 类 懂得 如 何 生成 素数 列表 。 注 意 ， 这 并 不 意味 着 要 
实体 化 为 对 象 。 该 类 就 是 个 有 用 的 作用 域 ， 在 其 中 声明 并 隐藏 变量 。 
如 有 果 计 算 素 数 的 算法 发 生 改动 ， 则 该 类 也 会 改动 。 

这 并 不 算是 重 写 ! 我 们 没 从 头 开 始 写 一 人 吉 程 序 。 实 际 上 ， 如 果 你 
仔细 看 上 述 两 个 不 同 的 程序 ， 束 会 发 现 它 们 采用 了 同样 的 算法 和 机 制 
来 完成 工作 。 

我 们 通过 编写 验证 第 一 个 程序 的 精确 行为 的 用 例 来 实现 修改 。 然 
后 ， 我 们 做 了 许多 小 改动 ， 每 次 改动 一 处 。 每 改动 一 次 ， 就 执行 一 
次 ， 确 保 程序 的 行为 没有 变化 。 一 小 步 接着 一 小 步 ， 第 一 个 程序 被 逐 
渐 请 理 和 转换 为 第 二 个 程序 。 
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他 部 分 不 能 如 期 望 般 工作 的 风险 。 在 整洁 的 系统 中 ， 我 们 对 类 加 以 组 
织 ， 以 降低 修改 的 风险 。 

代码 清单 10-9 中 的 Sql 类 用 来 生成 提供 恰当 元 数据 的 SQL 格式 化 字 
符 串 。 这 个 类 还 没 写 完 ， 所 以 暂时 不 文 持 update 语 句 等 SQL 功能 。 当 需 
要 Sql 类 文 持 update 语 句 时 ， 我 们 融 得 “打开 ”这 个 类 进行 修改 。 打 开关 
市 来 的 问题 是 风险 随 之 而 来 。 对 类 的 任何 修改 都 有 可 能 破坏 类 中 的 其 
他 代码 。 必 须 全 面 重新 测试 。 


代码 清单 10-9 一 个 必须 打开 修改 的 类 
public class Sql { 
public Sql(String table, Column[] columns) 
public String create() 
public String insert(Object[] fields) 
public String selectAll() 
public String findByKey(String keyColumn, String key Value) 
public String select(Column column, String pattern) 
public String select(Criteria criteria) 
public String preparedInsert() 
private String columnList(Column[] columns) 
private String valuesList(Object[] fields, final Column[] columns) 
private String selectWithCriteria(String criteria) 
private String placeholderList(Column[] columns) 

} 

当 增 加 一 种 新 语句 类 型 时 ， 就 要 修改 Sql 类 。 改 动 单个 语句 类 型 
时 ， 也 要 进行 修改 ， 比 如 打算 让 select 功 能 支持 子 查 询 。 存 在 两 个 修改 
的 理由 ， 说 明 Sql 违 反 了 SRP 原 则 。 

可 以 从 一 条 简单 的 组 织 性 观点 发 现 对 SRP 的 违反 。Sql 的 方法 大 纲 
显示 ， 和 存在 类 似 selectWithCriteria 等 只 与 select 语 句 有 天 的 私有 方法 。 

出 现 了 只 与 类 的 一 小 部 分 有 关 的 私有 方法 行为 ， 意 味 着 存在 改进 
空间 。 然 而 ， 展 开行 动 的 基本 动因 却 应 该 是 系统 的 变动 。 知 我 们 认为 
Sql 类 在 逻辑 上 已 具足 ， 则 无 需 担 心 对 权 责 的 拆 分 。 如 果 在 可 预见 的 未 
来 无 需 增 加 update 功 能 ， 驶 该 不 去 动 Sql 类 。 不 过 ， 一 旦 打开 了 类 ， 惑 
应 当 修 正 设计 方案 。 

代码 清单 10-10 中 的 解决 方式 如 何 呢 ? 代码 清单 10-9 中 Sql 类 的 每 个 
接口 方法 都 重 构 到 从 Sql 类 派生 出 来 的 类 中 了 “。 注 意 那些 私有 方法 ， 如 


valuesList， 直 接 移 到 了 需要 用 它们 的 地 方 。 公 共 私 有 行为 被 划分 到 独 
立 的 两 个 工具 类 Where 和 ColumnList 中 。 
代码 清单 10-10 一 组 封闭 类 
abstract public class Sql { 
public Sql(String table, Column[] columns) 
abstract public String generate(); 
} 
public class CreateSql extends Sql { 
public CreateSql(String table, Column[] columns) 
@Override public String generate() 
} 
public class SelectSql extends Sql { 
public SelectSql(String table, Column[] columns) 
@Override public String generate() 
} 
public class InsertSql extends Sql { 
public InsertSql(String table, Column[] columns, Object[] fields) 
@Override public String generate() 
private String valuesList(Object[] fields, final Column[] columns) 
} 
public class SelectWithCriteriaSgl extends Sql { 
public SelectWithCriteriaSql( 
String table, Column[] columns, Criteria criteria) 
@Override public String generate() 
} 
public class SelectWithMatchSql extends Sql { 
public SelectWithMatchSql( 


String table, Column[] columns, Column column, String pattern) 
@Override public String generate() 
} 
public class FindByKeySql extends Sql{ 
public FindByKeySql( 
String table, Column[] columns, String keyColumn, String 
key Value) 
@Override public String generate() 
} 
public class PreparedInsertSql extends Sql { 
public PreparedInsertSql(String table, Column[] columns) 
@Override public String generate(){ 
private String placeholderList(Column[] columns) 
} 
public class Where { 
public Where(String criteria) 
public String generate() 
} 
public class ColumnList { 
public ColumnList(Column[] columns) 
public String generate() 

} 

每 个 类 中 的 代码 都 变 得 极为 简单 。 理 解 每 个 类 花费 的 时 间 缩 减 到 
近乎 为 入。 图 数 对 其 他 函数 造成 又 坏 的 风险 也 变 得 几 近 于 无 。 从 测试 
的 角度 看 ， 验 证 方案 中 每 一 处 逻辑 都 成 了 极为 简单 的 任务 ， 因 为 类 与 
类 之 间 相 互 隔离 了 。 


当 需 要 增加 update 语 名 时， 现存 类 无 需 做 任何 修改 ， 这 也 同等 重 
要 ! 我 们 在 Sql 类 的 新 子 类 UpdateSql 中 构建 update 语 句 的 逻辑 。 系 统 
的 其 他 代码 都 不 会 因为 这 个 修改 而 被 破坏 。 

重新 架构 的 Sql 逻辑 百 利 而 无 一 葡 。 它 文 持 SRP。 它 也 文 持 其 他 面 
向 对 象 设 计 的 关键 原则 ， 如 开放 -闭合 原则 (OCP) [4]: 类 应 当 对 扩展 
开放 ， 对 修改 封 哮 。 通 过 子 类 化 手段 ， 重 新 染 构 的 Sq] 类 对 添加 新 功能 
是 开放 的 ， 而 且 可 以 同时 不 触及 其 他 类 。 只 要 将 UpdateSql 类 放置 到 位 
束 行 了 。 

我 们 希望 将 系统 打造 成 在 添加 或 修改 特性 时 尽 可 能 少 荐 奢 烦 的 架 
子 。 在 理想 系统 中 ， 我 们 通过 扩展 系统 而 非 修 改 现 有 代码 来 添加 新 特 
性 。 
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需求 会 改变 ， 所 以 代码 也 会 改变 。 在 OO 101[5] 中 ， 我 们 学 习 到 ， 
ARRAS SOT RE) ， 而 抽象 类 则 只 呈现 概念 。 依 赖 于 具体 
细 世 的 客户 类 ， 当 细 世 改变 时 ， 残 会 有 风险 。 我 们 可 以 借助 接口 和 抽 
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个 依赖 于 外 部 TokyoStockExchange API 的 Portfolio 类 ， 代 表 投 资 组 合 的 
价值 ， 则 测试 用 例 就 会 受到 价值 查询 的 连 融 影响 。 如 果 每 5 分 钟 就 有 新 
说 法 ， 殉 很 难 写 出 测试 来 。 

与 其 设计 直接 依赖 于 TokyoStockExchange 的 Portfolio 类 ， 不 如 创建 
StockExchange 接 口 ， 其 中 只 声明 一 个 方法 : 

public interface StockExchange 1 


Money currentPrice(String symbol); 
} 
我 们 设计 TokyoStockExchange 类 来 实现 这 个 接口 。 我 们 还 要 确保 
Portfolio 的 构造 器 接受 作为 参数 的 StockExchange 引 用 : 


public Portfolio ( 
private StockExchange exchange; 
public Portfolio(StockExchange exchange) { 
this.exchange = exchange; 
} 
Ian 
} 
现在 就 可 以 为 StockExchange 接口 创建 可 测试 的 尝试 性 实现 了 。 该 
笑 试 性 实现 将 返回 固定 的 现 值 。 如 果 测 试 中 购买 了 5 股 微软 股票 ， 则 壬 
试 性 实现 总 是 返回 每 股 100 美 元 的 现 值 。 对 于 StockExchange £L AZ 
试 性 实现 简化 为 简单 的 表格 查找 。 然 后 再 编写 一 个 总 投资 价值 为 500 美 
元 的 测试 。 
public class PortfolioTest { 


private FixedStockExchangeStub exchange; 

private Portfolio portfolio; 

@Before 

protected void setUp() throws Exception { 
exchange = new FixedStockExchangeStub(); 
exchange.fix(" MSFT", 100); 
portfolio = new Portfolio(exchange); 

} 

@Test 

public void GivenFiveMSFTTotalShouldBe500() throws Exception { 
portfolio.add(5, "MSFT"); 
Assert.assertEquals(500, portfolio.value()); 


如 有 果 系 统 解 耦 到 足以 这 样 测 试 的 程度 ， 也 残 更 加 灵活 ， 更 加 可 复 
用 。 部 件 之 间 的 解 耦 代表 着 系统 中 的 元 素 互 相 隅 离 得 很 好 。 隔 离 也 让 
对 系统 每 个 元 素 的 理解 变 得 更 加 容易 。 

通过 降低 连接 度 ， 我 们 的 类 就 遵循 了 另 一 条 类 设计 原则 ， 依 赖 倒 
置 原则 (Dependency Inversion Principle, DIP) [6]。 本 质 而 言 ，DIP 认 
为 类 应 当 依 赖 于 抽象 而 不 是 依赖 于 具体 细 廊 。 

我 们 的 Portfolio 类 不 再 依赖 于 TokyoStockExchange 类 的 实现 细 
节 ， 而 是 依赖 于 StockExchange 接 口 。StockExchange 授 口 呈现 的 是 有 关 
询问 某 只 股票 价格 的 抽象 概念 。 这 种 抽象 隔离 了 所 有 询 价 的 特定 细 
廊 ， 包 括 价格 数据 来 目 何 处 之 类 。 
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Kevin Dean WamplerT& + 


“复杂 要 人 命 。 它 消磨 开发 者 的 生命 ， 让 产品 难以 规划 、 构 建 和 测 
ike” 
Ray Ozzie， 微 软 公司 首 席 技 术 官 


你 能 自己 掌管 一 切 细 节 吗 ? 大 概 不 行 。 即 便 是 管理 一 个 既 存 的 城 
市 ， 也 是 一 个 人 无 法 做 到 的 。 不 过 ， 城 市 还 是 在 运转 (多 数 时 候 ) 。 
因为 每 个 城市 都 有 一 组 组 人 管理 不 同 的 部 分 ， 供 水 系统 、 供 电 系统 、 
交通 、 执 法 、 立 法 ， 诸 如 此 类 。 有 些 人 负责 全 局 ， 其 他 人 人 负责 细 甩 。 

城市 能 运转 ， 还 因为 它 演化 出 恰当 的 抽象 等 级 和 模块 ， 好 让 个 人 
和 他 们 所 管理 的 “组 件 ”" 即 便 在 不 了 解 全 局 时 也 能 有 效 地 运转 。 

尽管 软件 团队 往往 也 古 这 样 组 织 起 来 ， 但 他 们 所 致力 的 工作 却 肖 
党 没有 同样 的 关注 面 切 分 及 抽象 层级 。 整 涪 的 代码 帮助 我 们 在 较 低层 
的 抽象 层级 上 达成 这 一 目标 。 本 章 将 讨论 如 何在 较 高 的 抽象 层级 一 一 
系统 层级 一 LIRE ° 


11.2 将 系统 的 构造 二 


首先 ， 构 造 与 使 用 是 非常 不 一 样 的 过 程 。 当 我 走笔 至 此 ， 投 目 窗 
外 的 芝加哥 ， 看 到 有 一 间 酒 店 正 在 建设 。 今 天 ， 那 只 是 个 框架 结构 ， 
起 重 机 和 升降 机 附着 在 外 面 。 忙 碌 的 人 们 喘 穿 工作 服 ， 头 戴 安 全 帽 。 
大 概 一 年 之 后 ， 酒 店 束 将 建成 。 起 重 机 和 升降 机 都 会 消失 无 路。 建筑 
We re le, Fn SH ae he ER eR eo TEP TERET 
人 ， 会 看 到 完全 不 同 的 景象 。 

软件 系统 应 将 局 始 过 程 和 局 始 过 程 之 后 的 运行 时 逻辑 分 离开 ， 在 
局 始 过 程 中 构建 应 用 对 象 ， 也 会 存在 互相 缠 结 的 依赖 关系 。 

每 个 应 用 程序 都 该 留意 局 始 过 程 。 那 也 是 本 章 中 我 们 首先 要 考虑 
的 问题 。 将 关注 的 方面 分 离开 ， 和 是 软件 技 亿 中 最 古老 也 最 重要 的 设计 


技巧 。 
不 幸 的 是 ， 多 数 应 用 程序 都 没有 做 分 离 处 理 。 局 始 过 程 代码 很 特 
殊 ， 被 混杂 到 运行 时 逻辑 中 。 下 例 束 是 典型 的 情形 : 


public Service getService() 1 


if (service —- null) 
service = new MyServicelmpl(...); // Good enough default for 
most cases? 
return service; 

j 

这 就 是 所 谓 延 迟 初 始 化 / 嵌 值 ， 也 有 一 些 好 人 处。 在 真正 用 到 对 象 之 
前 ,无 需 操心 这 种 架空 构造 ， 启 始 时 间 也 会 更 短 ， 而 且 还 能 保证 永远 
不 会 返回 null 值 。 

然而 ， 我 们 也 得 到 了 MyServiceImpl 及 其 构造 器 所 需 一 切 (我 省 略 
了 那些 代码 ) 的 硬 编码 依赖 。 不 分 解 这 些 依赖 关系 就 无 法 编译 ， 即 便 
在 运行 时 永 不 使 用 这 种 类 型 的 对 象 

如 条 MyServiceImpl 是 个 重型 对 象 ， 则 测试 也 会 是 个 问题 。 我 们 必 
须 确保 在 单元 测试 调用 该 方法 之 前 ， 就 给 service 指派 恰当 的 测试 蔡 喘 

(TEST DOUBLE) [1] 或 仿制 对 象 (MOCK OBJECT) 。 由 于 构造 逻辑 
与 运行 过 程 相 混杂 ， 我 们 必须 测试 所 有 的 执行 路 径 例如 ，null 值 测试 
及 其 代码 块 ) 。 有 了 这 些 权 责 ， 说 明 方 法 做 了 不 止 一 件 事 ， 这 样 就 略 
微 违反 了 单一 权 员 原则 。 

最 糟糕 的 大 概 是 我 们 不 知道 MyServiceImpl 在 所 有 情形 中 是 否 都 是 
正确 的 对 象 。 我 在 代码 注释 中 做 了 暗示 。 为 什么 该 方法 所 属 类 必须 知 
道 全 局 情景 ? 我 们 是 否 真能 知道 在 这 里 要 用 到 的 正确 对 象 ? 是 否 真 有 
可 能 存在 一 种 放 之 四 海 而 缘 准 的 类 型 ? 

当然 ， 仅 出 现 一 次 的 延迟 初始 化 不 算是 产 重 问题 。 不 过 ， 在 应 用 
程序 中 往往 有 许多 种 类 似 的 情况 出 现 。 于 是 ， 全 局 设置 策略 《如果 有 


的 话 ) 在 应 用 程序 中 四 散 分 布 ， 缺 乏 模 块 组 织 性 ， 通 常 也 会 有 许多 重 
复 代 码 。 

如 果 我 们 勤 于 打造 有 着 良好 格式 并 且 强 固 的 系统 ， 丈 不 该 让 这 类 
就 手 小 技巧 破坏 模块 组 织 性 。 对 象 构造 的 启 始 和 设置 过 程 也 不 例外 。 
应 当 将 这 个 过 程 从 正常 的 运行 时 逻辑 中 分 离 出 来 ， 确 保 拥有 解决 主要 
依赖 问题 的 全 局 性 一 贯 策略 。 


11.2.1 分 解 main 


将 构造 与 使 用 分 开 的 方法 之 一 是 将 全 部 构造 过 程 搬迁 到 main 或 被 
称 之 为 main 的 模块 中 ， 设 计 系 统 的 其 余部 分 时 ， 假 设 所 有 对 象 都 已 正 
确 构 造 和 设置 (如 图 11-1 所 示 ) ° 

控制 流程 很 容易 理解 。main 画 数 创建 系统 所 需 的 对 象 ， 再 传递 给 
应 用 程序 ， 应 用 程序 只 管 使 用 。 注 意 看 横贯 main 与 应 用 程序 之 间隔 篇 
的 依赖 箭头 的 方向 。 它 们 都 从 main 画 数 向 外 走 。 这 表示 应 用 程序 对 
main 或 者 构造 过 程 一 无 所 知 。 它 只 是 简单 地 指望 一 切 已 齐备 。 


main - application 


l :build 


Builder A: co:Configured 
gto: Object 


图 11-1 将 构造 分 解 到 main( ) 中 


11.2.2 工厂 


当然 ， 有 时 应 用 程序 也 要 负责 确定 何 时 创建 对 象 。 比 如 ， 在 某 个 
订单 处 理 系统 中 ， 应 用 程序 必须 创建 Lineltem 实 体 ， 添 加 到 Order 对 
象 。 在 这 种 情况 下 ， 我 们 可 以 使 用 抽象 工厂 模式 [2] 让 应 用 自行 控制 何 
时 创建 LineItems， 但 构造 的 细节 却 隔离 于 应 用 程序 代码 之 外 。 


main OrderProcessing 


<<creates>> 
<<jnteriace>> 


LineltemFactory DX LineltemFactory 
Implementation \ / 


run (factory) 


+makeLineltem 


<<creates>> 


图 11-2 使 用 工厂 分 离 构 造 过 程 


再 留意 一 下 ， 所 有 依赖 都 是 从 main ts [A] OrderProcessing 应 用 程 
序 。 这 代表 应 用 程序 与 如 何 构建 LineItem 的 细 万 是 分 离开 来 的 。 构 建 能 
2] 由 LineltemFactoryImplementation #f 有 而 
LineItemFactoryImplementation 又 是 在 main 这 一 边 的 。 但 应 用 程序 能 完 
全 控制 LineItem 实 体 何 时 构建 ， 甚 至 能 传递 应 用 特定 的 构造 器 参数 。 


11.2.3 依赖 注入 


有 一 种 强大 的 机 制 可 以 实现 分 离 构 造 与 使 用 ， 那 就 是 依赖 注入 
(Dependency Injection, DI) ， 控 制 反 转 (Inversion of Control, IoC) 


在 依赖 管理 中 的 一 种 应 用 手段 [3]。 控制 反 转 将 第 二 权 责 从 对 象 中 拿 出 
来 ， 转 移 到 男 一 个 专注 于 此 的 对 象 中 ， 从 而 遵循 了 单一 权 员 原则。 在 
依赖 管理 情景 中 ， 对 象 不 应 负责 实体 化 对 目 身 的 依赖 。 反 之 ， 它 应 当 
将 这 份 权 员 移交 给 其 他 “有 权力 ”的 机 制 ， 从 而 实现 控制 的 反 转 。 因 为 
切 始 设置 吓 一 种 全 局 问题 ， 这 种 授权 机 制 通 第 要 么 是 main 例 程 ， 要 公 
是 有 特定 日 的 的 容 絮 。 

JNDI 查 找 是 DI 的 一 种 “部 分 ”实现 。 在 JNDI 中 ， 对 和 象 请 求 目 录 服 务 
妖 提 供 一 种 符合 某 个 特定 名 称 的 “服务 ”。 

MyService myService = (MyService) 
(jndiContext.lookup("NameOfMyService")); 

调用 对 象 并 不 控制 真正 返回 对 象 的 类 别 (当然 前 提 是 它 实现 了 恰 
当 的 接口 ) ， 但 调用 对 象 仍然 主动 分 解 了 依赖 。 

真正 的 依赖 注入 还 要 更 进一步 。 类 并 不 直接 分 解 其 依赖 ， 而 是 完 
全 被 动 的 。 它 提供 可 用 于 注入 依赖 的 赋值 器 方法 或 构造 器 参数 (或 二 
ARE) 。 在 构造 过 程 中 ，DI 容器 实体 化 需要 的 对 象 (通常 按 需 创 
£&) ， 并 使 用 构造 器 参数 或 赋值 器 方法 将 依赖 连接 到 一 起 。 至 于 哪个 
依赖 对 象 真 正 得 到 使 用 ， 是 通过 配置 文件 或 在 一 个 有 特殊 日 的 的 构造 
模块 中 编程 决定 。 

Spring 框架 提供 了 最 有 名 的 Java DI 容器 [4]。 用 户 在 XML 配 置 文件 
中 定义 互相 关联 的 对 象 ， 然 后 用 Java 代 码 请 求 特定 的 对 象 。 稍 后 我 们 就 
会 看 到 例子 。 

但 延 后 初始 化 的 好 处 是 什么 呢 ? 这 种 手段 在 DI 中 也 有 其 作用 。 首 
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提供 调用 工厂 或 构造 代理 的 机 制 ， 而 这 种 机 制 可 为 延迟 赋值 或 类 似 的 
优化 处 理 所 用 [5] © 
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人 涉足 ， 随 后 逐渐 拓宽 。 小 型 建筑 和 空地 渐渐 被 更 大 的 建筑 所 取代 ， 
一 些 地 方 最 终 鹿 立 起 摩天 大 楼 © 

一 开始 ， 供 电 、 供 水 、 下 水 、 互 联网 (OR!) 等 服务 全 部 欠 奉 。 
随 着 人 口 和 建筑 密度 的 增加 ， 这 些 服务 也 开始 出 现 。 

这 种 成 长 并 非 全 无 阵痛 。 你 有 多 少 次 开 着 车 ， 艰 难 穿行 过 一 个 “ 道 
路 改善 ?工程 ， 问 目 己 , “他 们 为 什么 不 一 开始 丈 修 条 够 宽 的 路 呢 ? ! ” 

不 过 那 无 论 如 何不 可 能 实现 。 谁 敢 打 包 票 说 在 一 个 小 镇 修建 一 条 
六 车 道 的 公路 并 不 痕 发 呢 ? 谁 会 想 要 这 么 一 条 穿 过 他 们 小 镇 的 路 呢 ? 

“一 开始 就 做 对 系统 ” 纯 属 神 话 。 反 之 ， 我 们 应 该 只 去 实现 今天 的 
用 户 故 事 ， 然 后 重 构 ， 明 天 再 扩展 系统 、 实 现 新 的 用 户 故 事 。 这 就 是 
大 代 和 增 量 敏捷 的 精髓 所 在 。 测 试 驱 动 开发 、 重 构 以 及 它们 打造 出 的 
整洁 代码 ， 在 代码 层面 你 证 了 这 个 过 程 的 实现 。 

但 在 系统 层面 又 如 何 ? 难道 系统 架构 不 需要 预先 做 好 计划 吗 ? 系 
统 理所当然 不 可 能 从 简单 递增 到 复杂 ， 它 能 行 吗 ? 

软件 系统 与 物理 系统 可 以 类 比 。 它 们 的 架构 都 可 以 递增 式 地 增 
长 ， 只 要 我 们 持续 将 关注 面 恰当 地 切 分 。 

如 我 们 将 见 到 的 那样 ， 软 件 系统 短 生 命 周期 本 质 使 这 一 切 变 得 可 
行 。 我 们 先 来 看 一 个 没有 充分 隔离 天 注 问题 的 架构 反例 。 

初始 的 EJB1 和 EJB2 架 构 没 有 恰当 地 切 分 关注 面 ， 从 而 给 有 机 增长 
压 上 了 不 必要 的 负担 。 比 如 一 个 持久 Bank 类 的 Entity Bean ° Entity bean 
是 天 系数 据 在 内 存 中 的 体现 ， 换 言 之 ， 是 表格 的 一 行 。 

首先 ， 你 要 定义 一 个 本 地 GERA) 或 远程 (分 离 的 JVM) d 
口 ， 供 客户 代码 使 用 。 代 码 清 单 11-1 就 是 一 种 可 能 的 本 地 接口 : 


代码 清单 11-1 Bank EJB 的 EJB2 本 地 接口 

package com.example.banking; 

import java.util.Collections; 

import javax.ejb.*; 

public interface BankLocal extends java.ejb.EJBLocalObject { 

String getStreetAddr1() throws EJBException; 

String getStreetAddr2() throws EJBException; 

String getCity() throws EJBException; 

String getState() throws EJBException; 

String getZipCode() throws EJBException; 

void setStreetAddr1(String street1) throws EJBException; 
void setStreetAddr2(String street2) throws EJBException; 
void setCity(String city) throws EJBException; 

void setState(String state) throws EJBException; 

void setZipCode(String zip) throws EJBException; 
Collection getAccounts() throws EJBException; 

void setAccounts(Collection accounts) throws EJBException; 
void addAccount(AccountDTO accountDTO) throws EJBException; 

} 

上 面 列 出 了 银行 地 址 的 几 个 属性 ， 和 一 组 该 银行 拥有 的 账户 ， 其 
中 每 个 账户 的 数据 都 由 单独 的 Account EJB 所 持 有 。 代 码 清单 11-2 展 示 
了 Bank bean 的 相应 实现 类 。 

代码 清单 11-2 相应 的 EJB2 Entity Bean 实 现 


package com.example.banking; 


import java.util.Collections; 
import javax.ejb.*; 


public abstract class Bank implements javax.ejb.EntityBean { 


/业务 逻辑 .… 

public abstract String getStreetA ddr1(); 

public abstract String getStreetAddr2(); 

public abstract String getCity(); 

public abstract String getState(); 

public abstract String getZipCode(); 

public abstract void setStreetAddr1(String street1); 

public abstract void setStreetAddr2(String street2); 

public abstract void setCity(String city); 

public abstract void setState(String state); 

public abstract void setZipCode(String zip); 

public abstract Collection getAccounts(); 

public abstract void setAccounts(Collection accounts); 

public void addAccount(AccountDTO accountDTO) { 
InitialContext context = new InitialContext(); 
AccountHomeLocal accountHome 

context.lookup("AccountHomeLocal"); 

AccountLocal account = accountHome.create(accountDTO); 
Collection accounts = getAccounts(); 
accounts.add(account); 

} 

// EJB container logic 

public abstract void setId(Integer id); 

public abstract Integer getId(); 

public Integer ejbCreate(Integer id) 1 ... } 

public void ejbPostCreate(Integer id) { ... } 


// The rest had to be implemented but were usually empty: 


public void setEntityContext(EntityContext ctx) {} 
public void unsetEntityContext() 1) 

public void ejbActivate() {} 

public void ejbPassivate() 1) 

public void ejbLoad() {} 

public void ejbStore() {} 

public void ejbRemove() { } 

} 

我 没有 列 出 对 应 的 LocalHome 接 口 ， 该 接口 基本 上 是 用 来 创建 对 象 
的 ， 也 没有 列 出 你 可 能 添加 的 Bank 查 找 器 (查询 ) 

最 后 ， 你 要 编写 一 个 或 多 个 XML 部 署 说 明 ， 将 对 象 相关 映射 细节 

和 定 给 某 个 持久 化 存储 空间 ， 说 明 期 望 的 事物 行为 、 安 全 约束 等 。 
业务 逻辑 与 EJB2 应 用 “ 容 妖 ”紧密 灯 合 。 你 必须 子 类 化 容器 类 型 ， 
必须 提供 许多 个 该 容 侨 所 需要 的 生命 周期 方法 。 

由 于 存在 这 种 与 重量 级 容器 的 紧 厢 合 ， 隔 离 单元 测试 就 很 困难 。 
有 必要 模拟 出 容器 (这 很 难 ) ， 或 者 花费 大 量 时 间 在 真实 服务 器 上 部 
车 EJB 和 测试 。 也 由 于 耦合 的 存在 ， 在 EJB2 织 构 之 外 的 复 用 实际 上 变 得 
不 可 能 。 

最 终 ， 连 面向 对 象 编程 本 身 也 被 侵蚀 。bean 不 能 继承 自 男 一 个 
bean « 留意 添 加 新 账号 的 逻辑 。 在 EJB2 bean 中 ， 定 义 一 种 本 质 上 是 无 
行为 struct 的 “数据 传输 对 象 ”(DTO) 很 常见 。 这 往往 会 导致 拥有 同样 
数据 的 元 余 类 型 出 现 ， 而 且 也 需要 在 对 象 之 间 复 制 数 据 的 八股 式 代 
码 。 

横贯 式 关 注 面 

在 某 些 领域 , EBJ2 染 构 已 经 很 接近 于 真正 的 关注 面 切 分 。 例 如 ， 
TE WRC or SAY eT le E H THIS ERA 
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注意 ， 持 久 化 之 类 关注 面 倾 向 于 横贯 某 个 领域 的 天 然 对 象 边 界 。 
你 会 想 用 同样 的 策略 来 持久 化 所 有 对 象 ， 例 如 ， 使 用 DBMS[6] 而 非 平 
面 文件 ， 表 名 和 列 名 遵循 某 种 命名 约定 ， 采 用 一 致 的 事务 语义 ， 等 
等 o 

原则 上 ， 你 可 以 从 模块 、 封 装 的 角度 推理 持久 化 策略 。 但 在 实践 
上 ， 你 却 不 得 不 将 实现 了 持久 化 策略 的 代码 铺展 到 许多 对 象 中 。 我 们 
用 术语 “横贯 式 天 注 面 " 来 形容 这 类 情况 。 同 样 ， 持 久 化 框架 和 领域 多 
辑 ， 孤 立地 看 也 可 以 是 模块 化 的 。 问 题 在 于 横贯 这 些 领域 的 情形 。 

实际 上 ，EJB 架 构 处 理 持 久 化 、 安 全 和 事务 的 方法 是 “预期 ”面向 方 
面 编程 (aspect-oriented programming, AOP) [Z]， 而 AOP 是 一 种 恢复 
横贯 式 关 注 面 模块 化 的 普 适 手段 。 

在 AOP 中 ， 被 称 为 方面 (aspect) 的 模块 构造 指明 了 系统 中 哪些 点 
的 行为 会 以 某 种 一 致 的 方式 被 修改 ， 从 而 文 持 某 种 特定 的 场景 。 这 种 
说 明 是 用 某 种 简洁 的 声明 或 编程 机 制 来 实现 的 。 

以 持久 化 为 例 ， 可 以 声明 哪些 对 象 和 属性 (或 其 模式 ) 应 当 被 持 
久 化 ， 然 后 将 持久 化 任务 委托 给 持久 化 框架 。 行 为 的 修改 由 AOPTEZR 
以 无 损 方式 [8] 在 目标 代码 中 进行 。 下 面 来 看 看 Java 中 的 三 种 方面 或 类 
似 方 面 的 机 制 。 


11.4 Java 代 理 


Java 代 理 适用 于 简单 的 情况 ， 例 如 在 单独 的 对 象 或 类 中 包装 方法 调 
用 。 然 而 ，JDK 提 供 的 动态 代理 仅 能 与 接口 协同 工作 。 对 于 代理 类 ， 你 
得 使 用 字 节 码 操 作 库 ， 比 如 CGLIB、ASM 或 Javassist[9]。 

代码 清单 11-3 展 示 了 为 我 们 的 Bank 应 用 程序 提供 持久 化 支持 的 JDK 
代理 ， 代 码 仅 覆盖 设置 和 取得 账号 列表 的 方法 。 


代码 清单 11-3 JDK 代 理 范 例 
// Bank.java (suppressing package names...) 
import java.utils.*; 
// The abstraction of a bank. 
public interface Bank 1 
Collection<Account> getAccounts(); 
void setAccounts(Collection<Account> accounts); 
} 
// BankImpl.java 
import java.utils.*; 
// The "Plain Old Java Object" (POJO) implementing the abstraction. 
public class BankImpl implements Bank 1 
private List<Account> accounts; 
public Collection<Account> getAccounts() { 
return accounts; 
j 
public void setAccounts(Collection<Account> accounts) { 
this.accounts = new ArrayList<Account>(); 
for (Account account: accounts) 1 


this.accounts.add(account); 


} 
// BankProxyHandler.java 


import java.lang.reflect.*; 
import java.util.*; 


// "InvocationHandler" required by the proxy API. 


public class BankProxyHandler implements InvocationHandler { 
private Bank bank; 
public BankHandler (Bank bank) { 
this.bank - bank; 
i 
// Method defined in InvocationHandler 
public Object invoke(Object proxy, Method method, Object[] args) 

throws Throwable 1 

String methodName = method.getName(); 

if (methodName.equals("getAccounts")) { 
bank.setAccounts(getAccountsFromDatabase()); 
return bank.getAccounts(); 

} else if (methodName.equals("setAccounts")) { 
bank.setAccounts((Collection<Account>) args[0]); 
setAccountsToDatabase(bank.getAccounts()); 
return null; 

} else { 


} 
// Lots of details here: 
protected Collection<Account> getAccountsFromDatabase() 1 ... } 
protected void setAccountsToDatabase(Collection<Account> 
accounts) { ... } 
} 
// Somewhere else... 


Bank bank = (Bank) Proxy.newProxyInstance( 


Bank.class.getClassLoader(), 
new Class[] { Bank.class }, 
new BankProxyHandler(new BankImpl())); 
我 们 定义 了 将 被 代理 包装 起 来 的 接口 Bank， 还 有 旧式 的 Java 对 和 象 
(Plain-Old Java Object, POJO) BankImpl， 该 对 象 实现 业务 逻辑 ( 稍 
后 再 来 看 POJO) ° 
Proxy API 需要 一 个 InvocationHandler 对 象 ， 用 来 实现 对 代理 的 全 
部 Bank 方法 调用 。BankProxyHandler 使 用 Java 反 射 API 将 一 般 方 法 调用 
映射 到 BankImpl 中 的 对 应 方法 ， 以 此 类 推 。 
即便 对 于 这 样 容 单 的 例 和 于 ， 也 有 许多 相对 复杂 的 代码 [10]。 使 用 那 
字 市 操作 类 库 也 同样 具有 挑战 性 。 代 码 量 和 复杂 度 是 代理 的 两 大 纶 
， 创 建 整洁 代码 变 得 很 难 ! 另外 ， 代 理 也 没有 提供 在 系统 范围 内 指 


些 
A 
定 执行 点 的 机 制 ， 而 那 正 是 真正 的 AOP 解 决 方案 所 必须 的 [11] ° 


11.5 纯 Java AOPTEZE 


幸运 的 是 ， 编 程 工具 能 目 动 处 理 大 多 数 代理 模板 代码 。 在 数 个 Java 
框架 中 ， 代 理 都 是 内 和 能 的， 如 Spring AOP 和 JBoss AOP 等 ， 从 而 能 够 以 
纯 Java 代 码 实现 面 同 方面 编程 [12]。 在 Spring 中 ， 你 将 业务 逻辑 编码 为 
旧式 Java 对 象 。POJO 上 自 扫 门 前 雪 ， 并 不 依赖 于 企业 框架 (或 其 他 
域 ，。 因 此 ， 它 在 概念 上 更 简单 、 更 易于 测试 驱动 。 相 对 简单 性 也 较 
易于 保证 正确 地 实现 相应 的 用 户 故 事 ， 并 为 未 来 的 用 户 故 事 维护 和 改 
进 代 码 。 

使 用 描述 性 配置 文件 或 API， 你 把 需要 的 应 用 程序 构架 组 合 起 来 ， 
包括 持久 化 、 事 务 、 安 人 全、 缓存 、 恢 复 等 横贯 性 问题 。 在 许多 情况 
下 ， 你 实际 上 只 是 指定 Spring 或 Jboss 类 库 ， 框 架 以 对 用 户 透 明 的 方式 处 


HEH Java {CHa ey FB PERS Ur » oce ESSI CARRE A (DI) 
容器 ，DI 容 器 再 实体 化 主要 对 象 ， 并 按 需 将 对 象 连接 起 来 。 
代码 清单 11-4 展 示 了 Spring V2.5 配 置 文件 app.xml 的 典型 片段 [13]。 
代码 清单 11-4 Spring 2.x 的 配置 文件 


«beans» 


<bean id="appDataSource" 
class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 
p:driverClassName-"com.mysgl.jdbc.Driver" 
p:url="jdbc:mysql://localhost:3306/mydb" 
p:username="me"/> 

<bean id="bankDataAccessObject" 
class="com.example.banking.persistence.BankDataAccessObject" 
p:dataSource-ref="appDataSource"/> 

<bean id="bank" 
class="com.example.banking.model.Bank" 


p:dataAccessObject-ref="bankDataAccessObject"/> 


</beans> 

TE ^» bean BERERE MBE He, EIA 
Z (DAO) 代理 (AR) 的 Bank 都 有 个 域 对 象 ， 而 bean 本 喘 又 是 由 
JDBC 张 动 程序 数据 源 代 理 (如 图 11-3 所 示 ) c 


AppDataSource 


客户 代码 


图 11-3“ 俄 罗斯 套 娃 ” 式 的 油漆 工 模 式 

客户 代码 以 为 调用 的 是 Bank 对 象 的 getAccount( ) 方 法 ， 其 实 它 是 
在 与 一 组 扩展 Bank POJO 基 础 行为 的 油漆 工 (DECORATOR) [14] 对 象 
中 最 外 面 的 那个 沟通 。 

在 应 用 程序 中 ， 只 添加 了 少数 几 行 代 码 ， 用 来 向 DI 容器 请 求 系统 
中 的 顶层 对 象 ， 如 XML 文 件 中 所 定义 的 那样 。 


XmlBeanFactory bf = 
new XmlBeanFactory(new ClassPathResource("app.xml", 
getClass())); 


Bank bank = (Bank) bf.getBean(" bank"); 

只 有 区 区 几 行 与 Spring 相关 的 Java 代 码 ， 应 用 程序 几乎 完全 与 
Spring 分 离 ， 消 除了 EJB2 之 类 系统 中 那 种 紧 耦 合 问题 。 

尽管 XML 可 能 会 元 长 且 难 以 阅读 [15]， 配 置 文件 中 定义 的 “党 略 ” 还 
是 要 比 那 种 隐藏 在 幕后 自动 创建 的 复杂 的 代理 和 方面 逻辑 来 得 简单 o 
这 种 类 型 的 架构 是 如 此 引 人 注 目 ，Spring 之 类 的 框架 最 终 导致 了 EJB 标 
准 在 第 3 版 的 彻底 变化 。 使 用 XML 配置 文件 和 /或 Java 5 annotation, 
EJB3 很 大 程度 上 遵循 了 Spring 通过 描述 性 手段 文 持 横贯 式 关注 面 的 模 
型 o 

代码 清单 11-5 展 示 了 用 EJB3 重 写 的 Bank 对 象 [16] © 

代码 清单 11-5 EJB3 版 本 的 Bank 


package com.example.banking.model; 


import javax.persistence.*; 
import java.util.ArrayList; 
import java.util.Collection; 
@Entity 
@Table(name = "BANKS") 
public class Bank implements java.io.Serializable { 
@Id @GeneratedValue(strategy=GenerationType.AUTO) 
private int id; 
@Embeddable // An object "inlined" in Bank's DB row 
public class Address 1 
protected String streetAddr1; 
protected String streetAddr2; 
protected String city; 
protected String state; 
protected String zipCode; 
i 
@Embedded 
private Address address; 
@OneToMany(cascade = CascadeType.ALL, fetch = 
FetchType.EAGER, 
mappedBy="bank") 
private Collection<Account> accounts = new ArrayList<Account>(); 
public int getId() { 
return id; 
} 
public void setId(int id) { 
this.id = id; 


} 

public void addAccount(Account account) { 
account.setBank(this); 
accounts.add(account); 

} 

public Collection<Account> getAccounts() { 
return accounts; 

} 

public void setAccounts(Collection<Account> accounts) { 
this.accounts = accounts; 

} 

} 

上 列 代 码 要 比 原本 的 EJB2 代 码 整 洁 多 了 。 有 些 实体 细 市 仍然 在 
annotation 中 存在 。 不 过 ， 因 为 没有 任何 信息 超出 annotation 之 外 ， 代 码 
依然 整洁 、 清 晰 ， 也 因此 而 易于 测试 驱动 、 易 于 维护 。 

如 果 愿 意 的 话 ，annotation 中 有 些 或 全 部 持久 化 信息 可 以 转移 到 
XML 部 署 描 述 中 ， 只 留 下 真正 的 纯 POJO。 如 果 持 久 化 映射 细节 不 会 频 
繁 改 动 ， 许 多 团队 可 能 会 选择 保留 annotation， 但 与 EJB2 那 种 侵害 性 相 
比 还 是 少 了 很 多 问题 。 


11.6 AspectJ 的 方面 


通过 方面 来 实现 关注 面 切 分 的 功能 最 全 的 工具 是 AspectJ 语 言 [17]， 
一 种 提供 “一 流 的 ”将 方面 作为 模块 构造 处 理 文 持 的 Java 扩 展 。 在 
80%~90% 用 到 方面 特性 的 情况 下 ，Spring AOP 和 JBoss AOP 提 供 的 纯 
Java 实 现 手段 足够 使 用 。 然 而 ，AspectJ 却 提供 了 一 套用 以 切 分 关注 面 


的 丰富 而 强 有 力 的 工具 。AspectJ 的 弱势 在 于 ， 需 要 采用 几 种 新 工具 ， 
学 习 新 语言 构造 和 使 用 方式 。 

厌 由 AspectU 近 期 引入 的 “annotation form” (使 用 Java 5 annotation 定 
义 纯 Java 代 码 的 方面 ) ， 新 工具 采用 的 问题 大 大 减少 。 男 外 ，Spring 
Framework 也 有 一 些 让 拥有 较 少 AspectJ 经 验 的 团队 更 容易 组 合 基于 
annotation 的 方面 的 特性 。 

X T AspectJ 的 全 面 探讨 已 经 超出 本 书 范 围 。 更 多 信息 可 参见 
[AspectUJ]、[Colyerl] 和 [Spring]。 


11.7 测试 驱动 系统 


通过 方面 式 的 手段 切 分 关注 面 的 威力 不 可 低估 。 假 使 你 能 用 POJO 
编写 应 用 程序 的 领域 逻辑 ， 在 代码 层面 与 架构 关注 面 分 离开 ， 就 有 可 
能 真正 地 用 测试 来 驱动 架构 。 采 用 一 些 新 技术 ， 就 能 将 架构 按 需 从 简 
单 演化 到 精细 。 没 必要 先 做 大 设计 (Big Design Up Front, BDUF) 
[18]。 实际 上 ，BDUF 甚 至 是 有 害 的 ， 它 阻碍 改进 ， 因 为 心理 上 会 抵制 
丢弃 既成 之 事 ， 也 因为 架构 上 的 方案 选择 影响 到 后 续 的 设计 思路 。 

建筑 设计 师 不 得 不 做 BDUF， 因 为 一 旦 建造 过 程 开始 ， 就 不 可 能 对 
大 型 物理 建筑 的 结构 做 根本 性 改动 [19]。 尽管 软 件 也 有 物理 [20] 的 一 
面 ， 只 要 软件 的 构架 有 效 切 分 了 各 个 关注 面 ， 还 是 有 可 能 做 根本 性 改 
动 的 。 

这 意味 着 我 们 可 以 从 “简单 自然 ”但 切 分 良好 的 架构 开始 做 软件 项 
目 ， 快 速 交 付 可 工作 的 用 户 故 事 ， 随 着 规模 的 增长 添加 更 多 基础 架 
构 。 有 些 世 界 上 最 大 的 网 站 采用 了 精密 的 数据 缓存 、 安 人 全、 虚拟 化 等 
技术 ， 获 得 了 极 高 的 可 用 性 和 性 能 ， 在 每 个 抽象 层 和 范围 之 内 ， 那 些 
最 小 化 耦合 的 设计 都 简单 到 位 ， 效 率 和 灵活 性 也 随 之 而 来 。 


SA, XR eWE SII MBA SAE oF AA un 
` 目标 、 项 目 进度 和 最 终 系统 的 总 体 构架 ， 我 们 会 有 所 预期 。 不 
过 ， 我 们 必须 有 能 力 随 机 应 变 。 

EJB 早期 架构 就 是 一 种 著名 的 过 度 工程 化 而 没 能 有 效 切 分 关注 面 
的 API。 在 没 能 真正 得 到 使 用 时 ， 设 计 得 再 好 的 API 也 等 于 是 杀 鸡 用 牛 
刀 。 优 秀 的 API 在 大 多 数 时 间 都 该 在 视线 之 外 ， 这 样 团队 才能 将 创造 力 
集中 在 要 实现 的 用 户 故 事 上 。 否 则 ， 架 构 上 的 约束 束 会 妨碍 问 客 户 交 
付 优化 价值 的 软件 。 

概 言 之 ， 

最 佳 的 系统 架构 由 模块 化 的 关注 面 领 域 组 成 ， 每 个 关注 面 均 用 纯 
Java (或 其 他 语言 ) 对 象 实现 。 不 同 的 领域 之 间 用 最 不 具有 侵害 性 的 方 
面 或 类 方面 工具 整合 起 来 。 这 种 絮 构 能 测试 弛 动 ， 束 像 代 码 一 样 。 


11.8 优化 i 


模块 化 和 关注 面 切 分 成 束 了 分 艇 化 管理 和 决策 。 在 巨大 的 系统 
中 ， 不 管 是 一 座 城市 或 一 个 软件 项 目 ， 无 人 能 做 所 有 决策 。 

众所周知 ， 最 好 是 授权 给 最 有 资格 的 人 。 但 我 们 党 第 瑟 记 了 ， 延 
人 迟 决策 至 最 后 一 刻 也 是 好 手段 。 这 不 古 懒 情 或 不 人 负责， CURATE 
基于 最 有 可 能 的 信息 做 出 选择 。 提 前 决策 古 一 种 预备 知识 不 足 的 决 
策 。 如 来 决策 太 早 ， 束 会 缺少 太 多 客户 反馈 、 关 于 项 目的 思考 和 实施 
经 验 。 

拥有 模块 化 关注 面 的 POJO 系 统 提供 的 敏捷 能 力 ， 人 允许 我 们 基于 最 
新 的 知识 做 出 优化 的 、 时 机 刚好 的 决策 。 决 策 的 复杂 性 也 降低 了 。 


建筑 构造 大 有 可 观 ， 既 因为 新 建筑 的 构建 过 程 (即便 是 在 隆冬 季 
节 ) ， 也 因为 那些 现今 科技 所 能 实现 的 超凡 设计 。 建 筑 业 是 一 个 成 熟 
行业 ， 有 着 高 度 优化 的 部 件 、 方 法 和 入 经 岁月 历练 的 标准 。 

即便 是 轻 量 级 和 更 直截了当 的 设计 已 足 甫 使 用 ， 许 多 团队 还 是 采 
用 了 EJB2 架构 ， 只 因为 EJB2 是 个 标准 。 我 见 过 一 些 团 队 ， 纠 缠 于 这 个 
或 那个 名 声 大 噪 的 标准 ， 却 形 失 了 对 为 客户 实现 价值 的 关注 。 

有 了 标准 ， 就 更 易 复 用 想法 和 组 件 、 雇 用 拥有 相关 经 验 的 人 才 、 
封装 好 点 子 ， 以 及 将 组 件 连 接 起 来 。 不 过 ， 创 立 标 准 的 过 程 有 时 却 漫 
长 到 行业 等 不 及 的 程度 ， 有 些 标准 没 能 与 它 要 服务 的 采用 者 的 真实 需 
求 相 结合 。 


11.10 系统 和 H BE 


建筑 ， 与 大 多 数 其 他 领域 一 样 ， 发 展 出 一 套 丰 富 的 语言 ， 有 词 
汇 、 熟 语 和 清晰 而 简洁 地 表达 基础 信息 的 句 式 [21]。 在 软件 领域 ,领域 
特定 语言 (Domain-Specific Language, DSL) [22] 最 近 重 受 关注 。DSL 
是 一 种 单独 的 小 型 脚本 语言 或 以 标准 语言 写 束 的 API， 领 域 专 家 可 以 用 
它 编 写 读 起 来 像 是 组 织 严 间 的 散文 一 般 的 代码 。 

优秀 的 DSL 填 平 了 领域 概念 和 实现 领域 概念 的 代码 之 间 的 “壕沟 ”， 
束 像 敏捷 实践 优化 了 开发 团队 和 甲 方 之 间 的 沟通 一 样 。 如 果 你 用 与 领 
域 专 家 使 用 的 同一 种 语言 来 实现 领域 逻辑 ， 束 会 降低 不 正确 地 将 领域 
翻译 为 实现 的 风险 。 


DSL 在 有 效 使 用 时 能 提升 代码 惯用 法 和 设计 模式 之 上 的 抽象 层 
次 。 它 允许 开发 者 在 恰当 的 抽象 层级 上 直 指 代码 的 初衷 。 

领域 特定 语言 多 许 所 有 抽象 层级 和 应 用 程序 中 的 所 有 领域 ， 从 高 
级 策略 到 底层 细 下 ， 使 用 POJO 来 表达 。 


11.11 小 结 


系统 也 应 该 是 整洁 的 。 侵 害 性 架构 会 沐 允 领域 逻辑 ， 冲 击 敏捷 能 
力 。 当 领域 逻辑 受到 困扰 ， 质 量 也 束 堪 忧 ， 因 为 缺陷 更 易 隐藏 ， 用 户 
故事 更 难 实现 。 当 敏捷 能 力 受到 损害 时 ， 生 产 力也 会 降低 ，TDD 的 好 
AX A YR R. © 

在 所 有 的 抽象 层级 上 ， 意 图 都 应 该 清晰 可 辨 。 只 有 在 编写 POJO 并 
使 用 类 方面 的 机 制 来 无 损 地 组 合 其 他 关注 面 时 ， 这 种 事情 才 会 发 生 。 

无 论 是 设计 系统 或 单独 的 模块 ， 别 未 了 使 用 大 概 可 工作 的 最 简单 


方案 。 
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[1]. 原 注 : [Mezzaros07] ° 


[2]. 原 注 : [GOF] ° 


[3]. 原 注 : 可 参见 [Fowler] ° 
[41: 原 注 :， 见 [Spring]。 另 外 也 有 一 个 Spring.NET 框 架 。 


[5]. 原 注 : 别 起 记 延 迟 初 始 化 /峰值 只 十 一 种 优化 手段 ， 而 且 可 能 是 一 种 
不 成 熟 的 手段 。 


[6]. 原 注 : 数据 管理 系统 。 


[7]. 原 注 : 查阅 [AOSD] 获 取 有 关 方 面 的 一 般 信息 ， 查 阅 [AspectJ] 和 
[Colyer] 获 取 有 天 AspectJ 的 信息 。 


[8]. 原 注 : 即 无 需 手 工 修改 源 代码 。 

[9]. 原 注 : 见 [CGLIB]、[ASM] 和 [Javassist] ° 

[10]. 原 注 : 要 想 了 解 更 多 关于 Proxy API 及 其 用 法 ， 请 参阅 [Goetz] ° 
(JRE: AOP 有 时 会 与 实现 它 的 技术 相 混淆 ， 例 如 方法 拦截 和 通过 代 
。AOP 系 统 的 真正 价值 在 于 用 简洁 和 模块 化 的 方式 指定 


[12]. 原 注 : 见 [Spring] 和 [JBoss]。“ 纯 Java” 表 示 不 使 用 AspectJ。 


[13]. 原 注 : 摘自 http://wwwi.theserverside.com/tt/articles/article.tss? 
l=IntrotoSpring25 ° 


[14]. 原 注 : [GOF] ° 


[15]. 原 注 : 可 以 使 用 遵循 “约定 胜 于 配置 ?的 机 制 和 Java 5 annotation 来 减 
少 外 露 的 连接 逻辑 ， 从 而 人 简化 这 个 例子 。 


http://www.onjava.com/pub/a/onjava/2006/05/17/standardizing-with-ejb3- 
java-persistence-api.html ° 


[17]. 原 注 : 参见 [AspectJ] 和 [Colyer]。 


[18]. 原 注 : BDUF 是 一 种 预先 设计 好 一 切实 现 的 方式 ， 不 能 与 移 做 设计 
(up-front design) 的 良好 实践 手段 相 混 消 。 


DIJNE: 即便 在 构建 开始 之 后 ， 也 会 有 大 量 迭 代 式 的 考察 和 细节 讨 
AS 


ie ° 
[20]. 原 注 : “软件 物理 ”一 词 最 早 由 [Kolence] 提 出 。 
[21]. 原 注 : [Alexander] 的 著作 对 软件 社区 影响 至 深 。 


[22]. 原 注 : 参见 [DSL]。[JMock] 是 创建 DSL 的 Java API 的 优秀 范例 © 
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假使 有 4 条 简单 的 规矩 ， 跟 着 做 就 能 帮助 你 创建 优良 的 设计 ， 会 如 
fup? 假使 遵循 这 些 规矩 你 就 能 洞 见 代码 的 结构 和 设计 ， 更 轻易 地 应 用 
SRP 和 DIP 之 类 原则 ， 又 会 如 何 ? 

我 们 中 的 许多 人 认为 ，Kent Beck 关 于 简单 设计 [1] 的 四 条 规则 ， 对 
于 创建 具有 良好 设计 的 软件 有 着 莫大 的 帮助 。 

据 Kent 所 述 ， 只 要 遵循 以 下 规则 ， 设 计 残 能 变 得 “简单 ”: 

运行 所 有 测试 ; 

不 可 重复 ; 

表达 了 程序 员 的 意图 ; 

尽 可 能 减少 类 和 方法 的 数量 ; 

以 上 规则 按 其 重要 程度 排列 。 


设计 必须 制造 出 如 预期 一 般 工 作 的 系统 ， 这 是 首要 因素 。 系 统 
许 有 一 套 绝 佳 设 计 ， 但 如 果 缺 乏 验证 系统 是 否 真 按 预 期 那样 工作 的 简 
单方 法 ， 那 惑 无 异 于 纸上谈兵 。 

全 面 测试 并 持续 通过 所 有 测试 的 系统 ， 束 是 可 测试 的 系统 。 看 似 
浅显 ， 但 却 重要 。 不 可 测试 的 系统 同样 不 可 验证 。 不 可 验证 的 系统 ， 
绝 不 应 部 署 。 

See, ARAMA, MES RRA) AAA 
WIT A ° ISIASRPRIR, MGR BC tal EE e MGA ee, UO 
能 持续 走 同 编写 较 易 测试 的 人 代码。 所以， 确保 系 统 完 全 可 测试 能 帮助 
我 们 创建 更 好 的 设计 。 

紧 耦 合 的 代码 难以 编写 测试 。 同 样 ， 编 写 测 试 越 多 ， 残 越 会 天 人 循 
DIP 之 类 规则 ， 使 用 依赖 注入 、 接 口 和 抽象 等 工具 尽 可 能 减少 耦合 。 如 


此 一 来 ， 设 计 束 有 长 足 进 步 。 
遵循 有 关 编 写 测试 并 持续 运行 测试 的 简单 、 明 确 的 规则 ， 系 统 就 
会 更 贴近 OO 低 厢 合 度 、 高 内 聚 度 的 目标 。 编 写 测试 引致 更 好 的 设计 。 
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步 了 吗 ? 如 末 是 ， 殊 要 清理 它 ， 并 且 运 行 测试 ， 保 证 没有 破坏 任何 东 
西 。 测 试 消除 了 对 清理 代码 就 会 破坏 代码 的 寻 惧 。 

在 重 构 过 程 中 ， 可 以 应 用 有 关 优 秀 软 件 设计 的 一 切 知识 。 提 升 内 
聚 性 ， 降 低 耦 合 度 ， 切 分 关注 面 ， 模 块 化 系统 性 关注 面 ， 缩 小 函数 和 
类 的 尺寸 ， 选 用 更 好 的 名 称 ， 如 此 等 等 。 这 也 是 应 用 简单 设计 后 三 条 
规则 的 地 方 : 消除 重复 ， 保 证 表达 力 ， 尽 可 能 减少 类 和 方法 的 数量 。 


12.4 不 可 重复 
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风险 和 额外 且 不 必要 的 复杂 度 。 重 复 有 多 种 表现 。 极 其 雷同 的 代码 行 
当然 是 重复 。 类 似 的 代码 往往 可 以 调整 得 更 相似 ， 这 样 就 能 更 容易 地 
进行 重 构 。 重 复 也 有 实现 上 的 重复 等 其 他 一 些 形 态 。 例 如 ， 在 某 个 群 
集 类 中 可 能 会 有 两 个 方法 : 


int size() {} 


boolean isEmpty() {} 


这 两 个 方法 可 以 分 别 实 现 。isEmpty 方 法 跟踪 一 个 布尔 值 ， 而 size 
方法 则 跟 踩 一 个 计数 右 。 或 者 ， 也 可 以 通过 在 isEmpty 中 使 用 size 方 法 
来 消除 重复 : 

boolean isEmpty() { 

return 0 == size(); 

} 

要 想 创 建 整洁 的 系统 ， 需 要 有 消除 重复 的 意愿 ， 即 便 对 于 短 短 几 
行 也 是 如 此 。 例 如 以 下 代码 : 

public void scaleToOneDimension( 

float desiredDimension, float imageDimension) 1 
if (Math.abs(desiredDimension - imageDimension) < 
errorThreshold) 
return; 
float scalingFactor = desiredDimension / imageDimension; 
scalingFactor = (float)(Math.floor(scalingFactor * 100) * 0.01f); 
RenderedOp newImage = ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor); 
image.dispose(); 
System.gc(); 
image = newlmage; 

j 

public synchronized void rotate(int degrees) { 

RenderedOp newImage = ImageUtilities.getRotatedImage( 
image, degrees); 

image.dispose(); 

System.gc(); 


image = newlmage; 


} 
要 保持 系统 整洁 ， 应 该 消除 scaleToOneDimension 和 rotate 方 法 里 面 
的 少量 重复 : 
public void scaleToOneDimension( 
float desiredDimension, float imageDimension) 1 
if (Math.abs(desiredDimension - imageDimension) < 
errorThreshold) 
return; 
float scalingFactor = desiredDimension / imageDimension; 
scalingFactor = (float)(Math.floor(scalingFactor * 100) * 0.01f); 
replaceImage(ImageUtilities.getScaledImage( 
image, scalingFactor, scalingFactor)); 
} 
public synchronized void rotate(int degrees) { 
replaceImage(ImageUtilities.getRotatedImage(image, 
degrees)); 
i 
private void replaceImage(RenderedOp newImage) { 
image.dispose(); 
System.gc(); 
image = newImage; 
} 
做 了 一 点 点 共性 抽取 后 ， 我 们 意识 到 已 经 违反 了 SRP 原 则 。 所 以 ， 
可 以 把 一 个 新 方法 分 解 到 男 外 的 类 中 ， 从 而 提升 其 可 见 性 。 团 队 中 的 
其 他 成 员 也 许 会 发 现 进 一 步 抽 象 新 方法 的 机 会 ， 并 且 在 其 他 场景 中 复 
用 之 。“ 小 规模 复 用 ”可 大 量 降低 系统 复杂 性 。 要 想 实 现 大 规模 复 用 ， 
必须 理解 如 何 实现 小 规模 复 用 。 


模板 方法 模式 [2] 是 一 种 移 除 高 层级 重复 的 通用 技巧 。 例 如 : 
public class VacationPolicy { 
public void accrueUSDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
I 
// code to ensure vacation meets US minimums 
//... 
// code to apply vaction to payroll record 
// EUR 
} 
public void accrueEUDivisionVacation() { 
// code to calculate vacation based on hours worked to date 
Ian 
// code to ensure vacation meets EU minimums 
Ui a 
// code to apply vaction to payroll record 
//... 


} 

除了 计算 法 定 最 少数 量 假期 的 部 分 ，accrueUSDivisionVacation 和 
accrueEuropeanDivision Vacation 中 有 大 量 代 人 码 雷 同 。 那 部 分 的 算法 ， 依 
据 员 工 类 型 而 变 。 

可 以 通过 应 用 模板 方法 模式 来 消除 明显 的 重复 。 

abstract public class VacationPolicy { 

public void accrueVacation() 1 
calculateBaseVacationHours(); 


alterForLegalMinimums(); 


applyToPayroll(); 
} 
private void calculateBaseVacationHours() { /* ... */ }; 
abstract protected void alterForLegalMinimums(); 
private void applyToPayroll() { /* ... */ }; 
} 
public class USVacationPolicy extends VacationPolicy 1 
@Override protected void alterForLegalMinimums() { 
// US specific logic 
} 
} 
public class EUVacationPolicy extends VacationPolicy { 
@Override protected void alterForLegalMinimums() { 
// EU specific logic 
} 
} 
子 类 填充 了 accrueVacation 算 法 中 的 “空洞 "”， 提 供 不 重复 的 信息 。 


12.5 表达 力 


我 们 中 的 天 多 数 人 都 经 历 过 费解 代码 的 纠缠 。 我 们 中 的 许多 人 目 
己 束 编写 过 费解 的 代码 。 写 出 目 己 能 理解 的 代码 很 容易 ， 因 为 在 写 这 
些 代 码 时 ， 我 们 正 深 入 于 要 解决 的 问题 中 。 代 码 的 其 他 维护 者 不 会 那 
么 深入 ， 也 束 不 易 理 解 代码 。 

软件 项 目的 主要 成 本 在 于 长 期 维护 。 为 了 在 修改 时 尽量 降低 出 现 
缺陷 的 可 能 性 ， 很 有 必要 理解 系统 是 做 什么 的 。 当 系统 变 得 越 来 越 复 


杂 ， 开 发 者 束 需 要 越 来 越 多 的 时 间 来 理解 它 ， 而 且 也 极 有 可 能 误解 。 
所 以 ， 代 码 应 当 清 晰 地 表达 其 作者 的 意图 。 作 者 把 代码 写 得 越 清 晰 ， 
其 他 人 人 花 在 理解 代码 上 的 时 间 也 束 越 少 ， 从 而 减少 缺陷 ， 缩 减 维护 成 
本 。 

可 以 通过 选用 好 名 称 来 表达 。 我 们 想 要 听 到 好 类 名 和 好 函数 名 ， 
而 且 在 查看 其 权 责 时 不 会 大 吃 一 惊 。 

也 可 以 通过 保持 钞 数 和 类 斥 寸 短小 来 表达 。 短 小 的 类 和 和男 数 通 肖 
易于 命名 ， 易 于 编写 ， 易 于 理解 。 

还 可 以 通过 采用 标准 命名 法 来 表达 。 例 如 ， 设 计 模 式 很 大 程度 上 
忠 关 平 沟 通 和 表达 。 通 过 在 实现 这 些 模式 的 类 的 名 称 中 采用 标准 模式 
名 ， 例 如 COMMAND 或 VISITOR， 束 能 充分 地 向 其 他 开发 者 描述 你 的 
设计 。 

编写 民 好 的 单元 测试 也 具有 表达 性 。 测 试 的 主要 目的 之 一 整 古 通 
过 实例 起 到 文档 的 作用 。 读 到 测试 的 人 应 该 能 很 快 理解 某 个 类 是 做 什 
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写 出 能 工作 的 代码 ， 束 转移 到 下 一 个 问题 上 ， 没 有 下 足 功 夫 调 整 代 
码 ， 让 后 来 者 易于 阅读 。 记 住 ， 下 一 位 读 代码 的 人 最 有 可 能 是 你 目 
pe 
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上 。 选 用 较 好 的 名 称 ， 将 大 函数 切 分 为 小 函数 ， 时 时 照 指 自己 创建 的 
东西 。 用 心 是 最 珍 贯 的 货源 。 


dd 


12.6 Rage 


即便 是 消除 重复 、 代 码 表达 力 和 SRP 等 最 基础 的 概念 也 会 被 过 度 使 
用 。 为 了 保持 类 和 函数 短小 ， 我 们 可 能 会 造 出 太 多 的 细小 类 和 方法 。 
所 以 这 条 规则 也 主张 画 数 和 类 的 数量 要 少 。 

类 和 方法 的 数量 太 多 ， 有 时 是 由 毫 无 意义 的 教条 主义 导致 的 。 例 
如 ， 某 个 编码 标准 就 坚 称 应 当 为 每 个 类 创建 接口 。 也 有 开发 者 认为 ， 
字段 和 行为 必须 切 分 到 数据 类 和 行为 类 中 。 应 该 抵制 这 类 教条 ， 采 用 
更 实用 的 手段 。 

我 们 的 目标 是 在 保持 函数 和 类 短小 的 同时 ， 保 持 整 个 系统 短小 精 
悍 。 不 过 要 记 住 ， 这 在 关于 简单 设计 的 四 条 规则 里 面 是 优先 级 最 低 的 
一 条 。 上 所以， 尽管 使 天 和 函数 的 数量 尽量 少 是 很 重要 的 ， 但 更 重要 的 
却 是 测试 、 消 除 重复 和 表达 力 。 


12.7 小 结 


有 没有 能 蔡 代 经 验 的 一 套 人 简单 实践 手段 呢 ? 当然 不 会 有 有 。 男 一 方 
面 ， 本 章 中 写 到 的 实践 来 自 于 本 书 作者 数 十 年 经 验 的 精练 总 结 。 遵 循 
人 简单 设计 的 实践 手段 ， 开 发 者 不 必 经 年 学 习 束 能 掌握 好 的 原则 和 模 
we 
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“对 象 是 过 程 的 抽象 。 线 程 是 调度 的 抽象 。” 


James O Coplien[1] 

编写 整洁 的 并 发 程序 很 难 一 一 非常 难 。 编 写 在 单线 程 中 执行 的 代 
码 人 简单 得 多 。 编 写 表面 上 看 来 不 错 、 深 入 进去 却 文 离 破 雄 的 多 线程 代 
码 也 简单 。 系 统一 旦 遭受 压力 ， 这 种 代码 束 打 不 住 了 。 

本 章 将 讨论 并 发 编程 的 需求 及 其 困难 之 处 ， 并 给 出 一 些 对 付 这 些 
难点 、 编 写 整洁 的 并 发 代码 的 建议 。 最 后 ， 我 们 将 讨论 与 测试 并 发 代 
码 有 关 的 问题 。 

整洁 的 并 发 编程 是 个 复杂 话题 ， 值 得 用 一 整 本 书 来 讨论 。 本 书 只 
做 概览 ， 并 在 “并 发 编程 I 一 章 中 提供 更 详细 的 指引 。 如 果 你 只 是 对 并 
发 好 奇 ， 阅 读本 革 就 足够 了 。 如 果 你 需要 更 深入 地 理解 并 发 ， 就 应 读 


完整 个 指引 章 订 。 


13.1 为 什么 要 并 发 


并 发 是 一 种 解 耦 策略 。 它 帮助 我 们 把 做 什么 〈“ 目 的 ) 和 何 时 (时 
WL) 做 分 解 开 。 在 单线 程 应 用 中 ， 目 的 与 时 机 紧密 耦合 ， 很 多 时 候 只 
要 查看 堆栈 追踪 即 可 断定 应 用 程序 的 状态 。 调 试 这 种 系统 的 程序 员 可 
以 设 定 断 点 或 者 断 点 序列 ， 通 过 查看 到 达 哪 个 断 点 来 了 解 系统 状态 。 

解 耦 目的 与 时 机 能 明显 地 改进 应 用 程序 的 吞吐 量 和 结构 。 从 结构 
的 角度 来 看 ， 应 用 程序 看 起 来 更 像 是 许多 台 协 同 工 作 的 计算 机 ， 而 不 
是 一 个 大 循环 。 系 统 因 此 会 更 易于 被 理解 ， 给 出 了 许多 切 分 天 注 面 的 
PFE! 

例如 ，Web 应 用 的 Servlet 标 准 模式 。 这 类 系统 运行 于 Web 或 EJB 容 
怖 的 保护 们 之 下 ，Web 或 EJB 为 你 部 分 地 处 理 并 发 问题 。 当 有 Web 请 求 
时 ，servlet 就 会 异步 执行 。Servlet 程 序 员 无 需 管 理 所 有 的 请 求 。 原 则 


上 ， 每 次 servlet 是 在 自己 的 小 世界 中 执行 ， 与 其 他 servlet 的 执行 是 分 离 
的 。 

当然 ， 如 果 只 是 那么 简单 ， 也 就 没 必 要 写 这 一 章 了 。 实 际 上 ，Web 
容器 提供 的 解 耦 手段 离 完 美 还 差 得 远 。Servlet 程 序 员 得 非常 警惕 、 非 常 
小 心地 保证 并 发 程序 不 出 错 。 同 样 ，servlet 模 式 的 结构 性 好 处 还 是 很 明 


但 结构 并 非 采 用 并 发 的 唯一 动机 。 有 些 系 统 对 啊 应 时 间 和 吞吐 量 
有 有 要求， 需要 手工 编写 并 发 解决 方案 。 例 如 ， 考 虑 一 个 单线 程 信息 聚 
合 程序 ， 它 从 许多 Web 站 点 获取 信息 ， 再 合并 写 入 日 志 中 。 因 为 该 系统 
是 单线 程 时 ， 它 会 逐个 访问 Web 站 点 ， 在 开始 下 一 个 之 前 等 得 当前 站 点 
访问 完毕 。 每 天 的 执行 时 间 必 须 少 于 24 个 小 时 。 然 而 ， 随 看 要 访问 的 
站 点 越 来 越 多 ， 采 集 所 有 数据 人 论 费 的 时 间 也 越 来 越 多 ， 最 终 超过 了 24 
个 小 时 的 限制 。 单 线程 程序 许多 时 间 人 花 在 等 竺 Web 套 接 字 IO 结束 上 
面 。 通 过 采用 同时 访问 多 个 站 点 的 多 线程 算法 ， 束 能 改进 性 能 。 

或 者 ， 考 虑 某 个 每 次 花费 1 秒 钟 处 理 一 个 用 户 请 求 的 系统 。 该 系统 
在 用 户 量 较 少 的 时 候 啊 应 及 时 ， 但 随 着 用 户 数 增加 ， 系 统 的 啊 应 时 间 
也 增加 了 。 没 人 想 排 在 150 个 人 后 面 ! 通过 并 发 处 理 多 个 用 户 请 求 ， 就 
能 改进 系统 啊 应 时 间 。 

再 或 者 ， 考 虑 某 个 解释 大 量 数 据 集 、 但 只 在 处 理 完 全 部 数据 后 给 
出 一 个 完整 解决 方案 的 系统 。 或 许可 以 在 独立 的 计算 机 上 处 理 每 个 数 
据 集 ， 那 样 的 话 许多 数据 集束 能 并 行 地 得 到 处 理 。 

迷 思 与 误解 

看 来 有 足够 的 理由 采用 并 发 方案 。 然而， 如 前 文 所 述 ， 并 发 编程 
很 难 。 如 采 你 不 那么 细心 ， 融 会 摘出 不 堪 入 目的 东西 来 。 看 看 以 下 锦 
见 的 迷 思 和 误解 : 

(1) 并 发 总 能 改进 性 能 


并 发 有 时 能 改进 性 能 ， 但 只 在 多 个 线程 或 处 理 右 之 间 能 分 译 大 量 
等 待 时 间 的 时 候 管用 。 事 情 没 那么 简单 。 

(2) 编写 并 发 程序 无 需 修改 设计 

事实 上 ， 并 发 算法 的 设计 有 可 能 与 单线 程 系统 的 设计 极 不 相同 。 
目的 与 时 机 的 解 粳 往往 对 系统 结构 产生 巨大 影响 。 

(3) 在 采用 Web 或 EJB 容 器 的 时 候 ， 理 解 并 发 问题 并 不 重要 

实际 上 ， 你 最 好 了 解 容器 在 做 什么 ， 了 解 如 何 对 付 本 章 后 文 将 提 
到 的 并 发 更 新 、 死 锁 等 问题 。 

下 面 是 一 些 有 关 编 写 并 发 软件 的 中 肯 说 法 : 

并 发 会 在 性 能 和 编写 额外 代码 上 增加 一 些 开销 ; 

正确 的 并 发 是 复杂 的 ， 即 便 对 于 简单 的 问题 也 是 如 此 ; 

并 发 缺陷 并 非 总 能 重 现 ， 所 以 香 被 看 做 偶发 事件 [2] 而 忽略 ， 未 被 
当做 真 的 缺陷 看 待 ; 

并 发 常常 需要 对 设计 策略 的 根本 性 修改 。 


13.2 挑战 


并 发 编程 为 何如 此 之 难 ? 来 看 看 下 面 这 个 小 型 类 : 
public class X { 

private int lastIdUsed; 

public int getNextId() 1 

return ++lastIdUsed; 

} 
} 
比如 ， 创 建 x 的 一 个 实体 ， 将 lastIdUsed 设 置 为 42， 在 两 个 线程 中 共 

享 这 个 实体 。 假 设 这 两 个 线程 都 调用 getNextId( ) 方 法 ， 结 果 可 能 有 三 


种 输出 : 

线程 一 得 到 值 43， 线 程 二 得 到 值 44，lastIdUsed 为 44; 

线程 一 得 到 值 44， 线 程 二 得 到 值 43，lastIdUsed 为 44; 

线程 一 得 到 值 43， 线 程 二 得 到 值 43，lastIdUsed 为 43。 

第 三 种 结果 令 人 惊异 [3]， 当 两 个 线程 相互 影响 时 就 会 出 现 这 种 情 
况 。 这 是 因为 线程 在 执行 那 行 Java 代 码 时 有 许多 可 能 路 径 可 行 ， 有 些 路 
径 会 产生 错误 的 结 采 。 有 多 少 种 不 同 路 径 呢 ? 要 真正 回答 这 个 问题 ， 
需要 理解 Just-In-Time 编译 器 如 何 对 待 生 成 的 字 节 人 码 ， 还 要 理解 Java 内 
存 模型 认为 什么 东西 具有 原子 性 。 

简 答 一 下 ， 就 生成 的 字 节 码 而 言 ， 对 于 在 getNextId 方 法 中 执行 的 
那 两 个 线程 ， 有 12870 种 不 同 的 可 能 执行 路 人 径 [4]。 如 果 ]lastIdUsed 的 类 
型 从 int 变 为 long， 则 可 能 路 径 的 数量 将 增 至 2704156 种 。 当 然 ， 多 数 路 
径 都 得 到 正确 结果 。 问 题 是 其 中 一 些 不 能 得 到 正确 结果 。 


^i 


13.3 MU 


下 面 给 出 一 系列 防御 并 发 代码 问题 的 原则 和 技巧 。 
13.3.1 单一 权 责 原则 


单一 权 责 原则 (SRP) [5] 认 为 ， 方 法/ 类/ 组件 应 当 只 有 一 个 修改 的 
理由 。 并 发 设计 目 喘 足够 复 淋 到 成 为 修改 的 理由 ， 所 以 也 该 从 其 他 代 
码 中 分 离 出 来 。 不 驻 的 是 ， 并 发 实现 细节 常常 直接 幅 入 到 其 他 生产 代 
码 中 。 下 面 是 要 考虑 的 一 些 问 题 : 

并 发 相关 代码 有 目 己 的 开发 、 修 改 和 调 优 生命 周期 ; 


开发 相关 代码 有 目 己 要 对 付 的 挑战 ， 和 非 并 发 相关 代码 不 同 ， 而 
且 往 往 更 为 困难 ; 

即便 没有 周边 应 用 程序 增加 的 负担 ， 写 得 不 好 的 并 发 代码 可 能 的 
出 错 方式 数量 也 已 经 足 具 挑战 性 。 

建议 : 分 离 并 发 相关 代码 与 其 他 代码 [6]。 


13.3.2 推论 : j| 用 域 


如 我 们 所 见 ， 两 个 线程 修改 共享 对 象 的 同一 字段 时 ， 可 能 互相 干 
扰 ， 导 致 未 预期 的 行为 。 解 决 方案 之 一 是 采用 synchronized REFER 
码 中 保护 一 块 使 用 共享 对 象 的 临界 区 (critical section) 。 限 制 临 界 区 的 
数量 很 重要 。 更 新 共享 数据 的 地 方 越 多 ， 就 越 可 能 : 

你 会 筷 记 保护 一 个 或 多 个 临界 区 一 一 破坏 了 修改 共享 数据 的 代 
码 ; 

得 多 花 力气 保证 一 切 都 受到 有 效 防护 (破坏 了 DRY 原 则 [7]) ; 

很 难 找到 错误 源 ， 也 很 难 判断 错误 源 。 

建议 : WAGE; 严格 限制 对 可 能 被 共享 的 数据 的 访问 。 


13.3.3 推论 ， 使 用 数据 复 本 


避免 共享 数据 的 好 方法 之 一 惑 是 一 开始 束 避 免 共 吾 数 据 。 在 某 些 
情形 下 ， 有 可 能 复制 对 象 并 以 只 读 方 式 对 待 。 在 为 外 的 情况 下 ， 有 可 
能 复制 对 象 ， 从 多 个 线程 收集 所 有 复 本 的 结果 ， 并 在 单个 线程 中 合并 

jt 


5 结果 o 


yo 


如 果 有 避免 共享 数据 的 简易 手段 ， 结 果 代 码 束 会 大 大 减少 导致 错 
误 的 可 能 。 你 可 能 会 关心 创建 额外 对 象 的 成 本 。 值 得 试验 一 下 看 看 那 
是 否 真 是 个 问题 。 然 而 ， 假 使 使 用 对 象 复 本 能 避免 代码 同步 执行 ， 则 


因 避 免 了 锁定 而 省 下 的 价值 有 可 能 补偿 得 上 额外 的 创建 成 本 和 垃圾 收 
集 开销 。 


13.3.4 推论 : 线程 应 尽 可 能 地 独立 


让 每 个 线程 在 自己 的 世界 中 存在 ， 不 与 其 他 线程 共享 数据 。 每 个 
线程 处 理 一 个 客户 端 请 求 ， 从 不 共享 的 源头 接纳 所 有 请 求 数据 ， 存 储 
为 本 地 变量 。 这 样 一 来 ， 每 个 线程 都 像 是 世界 中 的 唯一 线程 ， 没 有 同 
步 需要 o 

例如 ，HttpServlet 的 子 类 接收 所 有 以 参数 形式 传递 给 doGet 和 doPost 
方法 的 信息 。 每 个 Servlet 都 像 拥 有 独立 虚拟 机 一 般 运行 。 只 要 Servlet 中 
的 代码 只 使 用 本 地 变量 ，Servlet 束 不 会 导致 同步 问题 。 当 然 ， 多 数 使 用 
servlet 的 应 用 程序 最 终 都 还 是 会 用 到 类 似 数 据 库 连 接 之 类 的 共享 资源 。 

建议 ， 党 试 将 数据 分 解 到 可 被 独立 线程 (可 能 在 不 同 处 理 器 上 ) 
操作 的 独立 子 集 。 


13.4 Java 


相对 于 之 前 的 版 本 ，Java 5 提供 了 许多 并 发 开发 方面 的 改进 。 在 用 
Java 5 编写 线程 代码 时 ， 要 注意 以 下 几 点 : 

使 用 类 库 提供 的 线程 安全 群集 ; 

使 用 executor 框 架 (executor framework) 执行 无 关 任务 ; 

尽 可 能 使 用 非 锁定 解决 方案 ; 

有 儿 个 类 并 不 是 线程 安全 的 。 

线程 安全 群集 


当 Java 还 年 轻 时 ，Doug Lea 编 写 J Concurrent Programming in Java 
(中 译 版 《Java 并 发 编程 》) 教程 [8]， 同 时 开发 了 儿 个 线程 安全 群 
集 ， 这 些 代 码 后 来 成 为 JDK 中 java.util.concurrent 包 的 一 部 分 。 该 代码 包 
中 的 群集 对 于 多 线程 解决 方案 是 安全 的 ， 执 行 良好 。 实 际 上 ， 在 几乎 
所 有 情况 下 ，ConcurrentHashMap 实 现 都 比 HashMap 表 现 得 好 。 它 还 文 
持 同步 并 发 读 写 ， 也 拥有 文 持 非 线程 安全 的 合成 操作 的 方法 。 如 果 部 
署 环 境 是 Java 5， 可 以 采用 ConcurrentHashMap。 
还 有 几 个 支持 高 级 并 发 设计 的 类 。 以 下 是 其 中 一 小 部 分 ， 如 表 13-1 
所 示 。 


表 13-1 支持 高 级 并 发 设计 的 类 (部 分 ) 


ReentrantLock 可 在 一 个 方法 中 获取 、 在 另 一 方法 中 释放 的 锁 
Semaphore 经 典 的 “信号 ”的 一 种 实现 ， 有 计数 器 的 锁 


CountDownLatch — 在 释放 所 有 等 待 的 线程 之 前 ， 等 待 指定 数量 事件 发 生 的 锁 。 这 样 ， 所 有 线程 都 平 等 
地 几乎 同时 启动 


EN: 检 读 可 用 的 类 。 对 于 Java， 掌 握 java.util.concurrent ^ 


java.util.concurrent.atomic 和 java.util.concurrent.locks。 


13.5 行 模 型 


有 几 种 在 并 发 应 用 中 切 分 行为 的 途径 。 要 讨论 这 些 途 径 ， 我 们 需 
要 理解 一 些 基础 定义 ， 如 表 13-2 所 示 。 


表 13-2 基础 定义 


限定 资源 并 发 环境 中 有 着 固定 尺寸 或 数量 的 资源 。 例 如 数据 库 连 接 和 固定 尺寸 读 / 写 缓存 等 

Hm 每 一 时 刻 仅 有 一 个 线程 能 访问 共享 数据 或 共享 资源 

线程 饥饿 一 个 或 一 组 线程 在 很 长 时 间 内 或 永久 被 禁止 。 例 如 ， 总 是 让 执行 得 快 的 线程 先 运行 ， 
假如 执行 得 快 的 线程 没完 没 了 ， 则 执行 时 间 长 的 线程 就 会 “ 挨 饿 ” 

死 锁 两 个 或 多 个 线程 互相 等 待 执 行 结束 。 每 个 线程 都 拥有 其 他 线程 需要 的 资源 ， 得 不 到 
其 他 线程 拥有 的 资源 ， 就 无 法 终止 

活 锁 执行 次 序 一 致 的 线程 ， 每 个 都 想 要 起 步 ， 但 发 现 其 他 线程 已 经 “在 路 上 ”。 由 于 竞 
步 的 原因 ， 线 程 会 持续 尝试 起 步 ， 但 在 很 长 时 间 内 却 无 法 如 愿 ， 甚 至 永远 无 法 启动 


有 了 这 些 定 义 ， 我 们 惑 能 讨论 在 并 发 编程 中 用 到 的 几 种 执行 模型 


13.5.1 生产 者 - 消 型 


[9] 

一 个 或 多 个 生产 者 线程 创建 某 些 工作 ， 并 置 于 缓存 或 队列 中 。 一 
个 或 多 个 消费 着 线程 从 队列 中 获取 并 完成 这 些 工 作 。 生 产 者 和 消费 者 
之 间 的 队列 是 一 种 限定 唤 源 。 


13.5.2 读者 - 型 


[10] 

当 存 在 一 个 主要 为 读 着 线程 提供 信息 源 ， 但 只 侦 尔 被 作者 线程 更 
新 的 共 译 资源 ， 否 吐 量 就 会 是 个 问题 。 增 加 否 吐 量 ， 会 导致 线程 饥 包 B 
和 过 时 信息 的 票 积 。 更 新 会 影响 吞吐 量 。 协 调 读者 线程 ， 不 去 读 作者 
线程 正在 更 新 的 信息 〈 反 之 亦 然 ) ， 这 是 一 种 芳和 否 的 平衡 工作 。 作 者 
线程 倾向 于 长 期 锁定 许多 读者 线程 ， 从 而 导致 吞吐 量 问题 。 

挑战 之 处 在 于 平衡 读者 线程 和 作者 线程 的 需求 ， 实 现 正确 操作 ， 
ERESHE, MERRIER o 
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13.5.3 


[11] 

想象 一 下 ， 一 群 哲学 家 环 坐 在 圆桌 旁 。 每 个 哲学 家 的 左手 边 放 了 
一 把 双子。 桌面 中 央 摆 着 一 大 砚 意 大 利 面 。 哲 学 家 们 思索 民 久 ， 直 至 
肚子 饿 了 。 每 个 人 都 要 拿 起 叉子 吃饭 。 但 除非 手 上 有 两 把 久子 ， 否 则 
束 没 法 进食 。 如 琳 左 边 或 右边 的 哲学 家 已 经 取 用 一 把 义 于 ， 中 间 这 位 
wi ter Se EN A ANZ SE > BUF o EMAFI, BRIE XFL 
FIRE, BEALS HR ° 

FACES SEAR, CURIS MP, MER Te Ly Fl 
HERES BELURBUTRIE ^ WRIA RUD. MESA MSI 
BIERA ` TB ARIE [HT e 

(Rey PEI URSI AC IRISH, KABA 3 — P AAA STR IRA 
并 使 用 这 些 算 法 ， 这 样 ， 巡 到 并 发 问题 时 你 束 能 有 人 解决 问题 的 准备 
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建议 : 学 习 这 些 基础 算法 ， 理 解 其 解决 方案 。 


同步 方法 之 间 的 依赖 会 导致 并 发 代码 中 的 狭 狂 缺 隐 。Java 语言 有 
synchronized 概 念 ， 可 以 用 来 保护 单个 方法 。 然 而 ， 如 果 在 同一 共享 类 
中 有 多 个 同步 方法 ， 系 统 束 可 能 写 得 不 太 正确 了 [12]。 

建议 : 避免 使 用 一 个 共享 对 象 的 多 个 方法 。 

有 时 必须 使 用 一 个 共享 对 象 的 多 个 方法 。 在 这 种 情况 发 生 时 ， 有 3 
种 写 对 代码 的 手段 : 

基于 客户 端的 锁定 一 一 客户 端 代码 在 调用 第 一 个 方法 前 锁定 服务 
疹 ， 确 保 锁 的 范围 禾 兽 了 调用 最 后 一 个 方法 的 代码 ; 


基于 服务 端的 锁定 一 一 在 服务 端 内 创建 锁定 服务 端的 方法 ， 调 用 
所 有 方法 ， 然 后 解锁 。 让 客户 端 代码 调用 新 方法 ; 

适 配 服务 端 一 一 创建 执行 锁定 的 中 间 层 。 这 是 一 种 基于 服务 端的 
颂 定 的 例子 ， 但 不 修改 原始 服务 端 代 码 。 


天 键 字 synchronized 制 造 了 锁 。 同 一 个 锁 维护 的 所 有 代码 区 域 在 任 
一 时 刻 保证 只 有 一 个 线程 执行 。 锁 是 昂 贯 的 ， 因 为 它们 市 来 了 延迟 和 
额外 开销 。 所 以 我 们 不 愿 将 代码 扔 给 synchronized 语 句 了 事 。 另 一 方 
面 ， 临 界 区 [13] 应 该 被 保护 起 来 。 所 以 ， 应 该 尽 可 能 少 地 设计 临界 区 。 

有 些 天 真 的 程序 员 想 通过 扩大 临界 区 面积 达到 这 个 目的 。 然 而 ， 
将 同步 延展 到 最 小 临界 区 苑 围 之 外 ， 会 增加 资源 争 用 、 降 低 执 行 效 率 
[14] ° 

建议 : 尽 可 能 减 小 同步 区 域 。 


13.8 很 难 编写 正确 的 关闭 代码 


编写 永远 运行 的 系统 ， 与 编写 运行 一 段 时 间 后 平静 地 关闭 的 系统 
是 两 码 事 。 

平静 关闭 很 难 做 到 。 和 营 见 问题 与 死 锁 [15] 有 关 ， 线 程 一 直 等 待 永远 
` 会 到 来 的 信号 。 

例如 ， 想 象 一 个 系统 中 有 个 父 线程 分 寞 出 数 个 子 线程 ， 父 线程 等 
待 所 有 子 线程 结束 ， 然 后 释放 货源 并 关闭 。 如 果 其 中 一 个 子 线程 发 生 
TOM EE? 父 线程 将 一 直 等 待 下去， 而 系统 束 永 远 不 能 关闭 。 


或 者 ， 考 虑 一 个 锌 指示 关闭 的 类 似 系统 。 父 线程 告知 全 体 子 线程 
放弃 任务 并 结束 。 如 果 其 中 两 个 子 线程 正 以 生产 者 /消费 者 模型 操作 会 
TEIE? 假设 生产 者 线程 从 父 线 程 处 接收 到 信号， 并 迅速 关闭。 消费 
者 线程 可 能 还 在 等 竺 生产 者 线程 发 来 消息 ， 于 是 丈 补 锁定 在 无 法 接收 
到 关闭 信号 的 状态 中 。 它 会 死 等 生产 者 线程 ， 永 不 结束 ， 从 而 导致 父 
线程 也 无 法 结束 。 

这 类 情形 并 非 那 么 不 筑 见 。 如 果 你 要 编写 涉及 平静 关闭 的 并 发 代 
码 ， 请 多 预 留 一 些 时 间 搞 对 关闭 过 程 。 

建议 : 尽早 考虑 关闭 问题 ， 尽 早 令 其 工作 正常 。 这 会 化 费 比 你 预 
期 更 多 的 时 间 。 检 视 既 有 算法 ， 因 为 这 可 能 会 比 想象 中 难得 多 。 


13.9 测试 线程 


证 明代 码 的 正确 性 不 切实 际 。 测 试 并 不 能 确保 正确 性 。 然 而 ， 好 
的 测试 却 能 尽量 降低 风险 。 这 对 于 所 有 单线 程 解决 方案 部 是 对 的 。 当 
有 两 个 或 多 个 线程 使 用 同一 代码 段 和 共享 数据 ， 事 情 就 变 得 非常 复杂 
[fe 

建议 : 编写 有 潜力 曝露 问题 的 测试 ， 在 不 同 的 编程 配置 、 系 统 配 
置 和 负载 条 件 下 频繁 运行 。 如 果 测 试 失 败 ， 跟 踊 错 误 。 别 因为 后 来 测 
试 通 过 了 后 来 的 运行 天 忽略 失败 。 

有 一 大 堆 问 题 要 考虑 。 下 面 是 一 些 精练 的 建议 : 

将 伪 失 败 看 作 可 能 的 线程 问题 ; 

先 使 非 线程 代码 可 工作 ; 

编写 可 插 拔 的 线程 代码 ; 

编写 可 调整 的 线程 代码 ; 

运行 多 于 处 理 器 数量 的 线程 ; 


在 不 同 平台 上 运行 ; 
调整 代码 并 强迫 错误 发 生 。 


13.9.1 将 伪 失 可 能 的 线程 问题 


线程 代码 导致 “不 可 能 失败 的 ”失败 。 多 数 开发 着 缺乏 有 关 线 程 如 
何 与 其 他 代码 〈 可 能 由 其 他 作者 编写 ) 互动 的 直觉 。 线 程 代 码 中 的 缺 
陷 可 能 在 一 千 或 一 百 万 次 执行 中 才 会 显现 一 次 。 重 复 执 行 想 要 复 现 问 
题 令 人 诅 形 。 所 以 开发 着 明明 会 将 失败 归 和 从 于 宇宙 射线 、 和 硬件 错 误 或 
其 他 “偶发 事件 *。 最 好 假设 这 种 偶发 事件 根本 不 存在 。“ 偶 发 事件 ”被 名 
略 得 越久 ， 代 码 就 越 有 可 能 搭建 于 不 完善 的 基础 之 上 。 

建议 : 不 要 将 系统 错误 归咎 于 偶发 事件 。 


13.9.2 FE 线程 代码 可 工 


这 看 起 来 太 浅显 ， 但 强调 一 下 不 无 益处 。 确 保 线程 之 外 的 代码 可 
工作 。 通 常 ， 这 意味 着 创建 由 线程 调用 的 POJO。POJO 与 线程 无 涉 ， 所 
以 可 在 线程 环境 之 外 测试 。 能 放 进 POJO 中 的 代码 越 多 越 好 。 

建议 : 不 要 同时 追踪 非 线程 缺陷 和 线程 缺陷 。 确 你 代码 在 线程 之 
外 可 工作 。 


13.9.3 编写 可 揪 拔 的 线程 代码 


编写 可 在 数 个 配置 环境 下 运行 的 线程 代码 : 
单线 程 与 多 个 线程 在 执行 时 不 同 的 情况 ; 
线程 代码 与 实物 或 测试 殖 身 互动 ; 

用 运行 快速 、 缓 慢 和 有 变动 的 测试 奉 吴 执行 ; 
将 测试 配置 为 能 运行 一 定数 量 的 大 代 。 


建议 : WA NATE IS, SERRE TE A EEN Na 


要 获得 民 好 的 线程 平衡 ， 常 常 需要 试 错 。 一 开始 ， 在 不 同 的 配置 
环境 下 监测 系统 性 能 。 要 人 允许 线程 数量 可 调整 。 在 系统 运行 时 允许 线 
程 发 生变 动 。 人 允许 线程 依据 吞吐 量 和 系统 使 用 率 目 我 调整 。 


13.9.5 运行 多 于 处 理 器 数量 的 线程 


系统 在 切换 任务 时 会 发 生 一 些 事 。 为 了 促使 任务 交换 的 发 生 ， 运 
行 多 于 处 理 器 或 处 理 器 核心 数量 的 线程 。 任 务 交换 越 频 繁 ， 越 有 可 能 
找到 错过 临界 区 或 导致 死 锁 的 代码 。 


13.9.6 在 不 同 平台 上 运行 


2007 年 ， 我 们 做 了 一 套 关 于 并 发 编程 的 谍 程 。 该 课程 主要 在 OS X 
下 开发 ， 在 运行 于 虚拟 机 的 Windows XP 上 展示 。 用 于 演示 的 测试 失败 
RIF, EOS X 上 要 比 在 XP 上 失败 得 更 频繁 。 

被 测试 的 代码 已 知 是 不 正确 的 。 这 正 强 调 了 不 同 操作 系统 有 着 不 
同 线程 策略 的 事实 ， 不 同 的 线程 策略 影响 了 代码 的 执行 。 在 不 同 环境 
中 ， 多 线程 代码 的 行为 也 不 一 样 [16]。 应 该 在 所 有 可 能 部 署 的 环境 中 运 
行 测 试 。 

建议 : 尽早 并 经 浓 地 在 所 有 目标 平台 上 运行 线程 代码 。 


13.9.7 装置 试 错 代码 


并 发 代码 中 藏 有 缺陷， 这 并 不 罕见 。 人 简单 的 测试 往往 无 法 曝露 这 
些 缺 陷 。 实 际 上 ， 人 缺陷 经 党 隐藏 于 一 般 处 理 过 程 中 。 可 能 好 几 个 小 
时 、 好 几 天 甚至 好 几 个 星期 才 会 跳出 来 一 次 ! 

线程 中 的 缺陷 之 所 以 如 此 不 频繁 、 贫 发 、 难 以 重 现 ， 是 因为 在 几 
千 个 罕 过 脆弱 区 域 的 可 能 路 人 径 当中 ， 只 有 少数 路 径 会 真 的 导致 失 败 。 
经 过 会 导致 失败 的 路 径 的 可 能 性 惊人 地 低 。 所 以 ， 侦 测 与 调试 也 非常 
之 难 。 

怎么 才能 增加 捕捉 住 如 此 罕见 之 物 的 机 会 ? 可 以 装置 代码 ， 增 加 
对 Object.wait( ) ` Object.sleep( ) ^ Object.yield( ) 和 Object.priority( ) 77 
法 的 调用 ， 改 变 代码 执行 顺序 。 

这 些 方法 都 会 影响 执行 顺序 ， 从 而 增加 了 侦 测 到 缺陷 的 可 能 性 。 
有 问题 的 代码 ， 最 好 尽早 、 尽 可 能 多 地 通 不 过 测试 。 

有 两 种 装置 代码 的 方法 : 

人 硬 编码 ; 

目 动 化 。 


13.9.8 硬 编 码 


A BY AF I I8] RS HP fé A wait( ) ^ sleep( ) ^ yield()FIpriority( ) 的 调 
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下 面 是 个 例子 : 
public synchronized String nextUrlOrNull() { 
if(hasNext()) { 

String url = urlGenerator.next(); 
Thread.yield(); // inserted for testing. 
updateHasNext(); 


return url; 


} 
return null; 
} 
插入 对 yield() 的 调用 ， 将 改变 代码 的 执行 路 径 ， 由 此 而 可 能 导致 
代码 在 以 前 未 失败 过 的 地 方 失 败 。 如 果 代 码 的 确 出 错 ， 那 并 非 是 因为 
你 插入 了 yield( ) 方 法 调用 [17]。 代 码 出 错 了 ， 这 便 是 失败 的 原因 。 
这 种 手法 有 许多 毛病 : 
你 得 手工 找到 合适 的 地 方 来 插入 方法 调用 ，; 
你 怎么 知道 在 哪里 插入 调用 、 揪 入 什么 调用 ? 
不 必要 地 在 产品 环境 中 留 下 这 类 代码 ， 将 拖 慢 代码 执行 速度 ; 
这 是 种 无 的 放 和 天 的 手段 。 你 可 能 找 不 到 缺陷 。 实 际 上 ， 这 不 在 你 
把 握 之 中 。 
我 们 所 需要 的 ， 是 一 种 在 测试 中 但 不 在 生产 中 实现 的 手段 。 我 们 
还 需要 为 多 次 运行 轻易 地 调整 配置 ， 从 而 增加 总 的 发 现 错误 机 会 。 
无 疑 ， 如 采 将 系统 分 解 为 对 线程 及 控制 线程 的 类 一 无 所 知 的 
POJO, ， 就 能 更 容易 地 找到 装置 代码 的 位 置 。 而 且 ， 还 能 创建 许多 个 以 
不 同方 式 调用 sleep、yield 等 方法 的 POJO 测 试 。 


13.9.9 目 动 化 


可 以 使 用 Aspect-Oriented Framework、CGLIB 或 ASM 之 类 工具 通过 
编程 来 装置 代码 。 例 如 ， 可 以 使 用 有 单个 方法 的 类 : 
public class ThreadJigglePoint { 
public static void jiggle() { 
} 
} 
可 以 在 代码 的 不 同位 置 调用 这 个 方法 : 


public synchronized String nextUrlOrNull() 1 
if(hasNext()) { 
ThreadJiglePoint.jiggle(); 
String url = urlGenerator.next(); 
ThreadJiglePoint.jiggle(); 
updateHasNext(); 
ThreadJiglePoint.jiggle(); 
return url; 
j 
return null; 
j 
如 此 ， 你 就 得 到 了 一 个 随机 选择 无 所 作为 、 睡 眠 或 让 步 的 方面 。 
或 者 ， 想 象 ThreadJigglePoint 类 有 两 种 实现 。 第 一 种 实现 jiggle 什 么 
都 不 做 ， 在 生产 环境 中 使 用 。 第 二 种 实现 生成 一 个 随机 数 ， 在 睡眠 、 
让 步 或 径直 执行 间 做 选择 。 如 果 上 千 次 地 做 这 种 随机 测试 ， 大 概 就 能 
找到 一 些 缺 陷 的 根源 。 假 如 测试 都 通过 了 ， 人 至 少 你 可 以 说 目 己 已 课 慎 
对 待 。 这 种 方法 看 似 有 点 过 于 简单 ， 但 确 是 奉 代 复 杂工 具 的 一 种 可 选 
方案 。 
有 一 种 叫做 ConTest[18] 的 工具 ， 由 IBM 开 发 ， 能 做 类 似 的 事情 ， 但 
做 法 却 稍微 复杂 些 。 
要 点 是 让 代码 “异动 "从 而 使 线程 以 不 同 次 序 执行 。 编 写 民 好 的 
测试 与 “异动 * 相 组 合 ， 能 有 效 地 增加 发 现 错 误 的 机 会 。 
建议 : 使 用 异动 策略 搜 出 错误 。 


13.10 小 结 
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会 变 成 时 梦 。 要 编写 并 发 代码 ， 束 得 关 格 地 编写 整 涪 的 代码 ， 否 则 将 
面临 微细 和 不 频 粽 发生 的 失败 。 

第 一 要 诀 足 休 循 单一 权 贡 原则 。 将 系统 切 分 为 分 离 了 线程 相关 代 
码 和 线程 无 天 代码 的 POJO。 确 保 在 测试 线程 相关 代码 时 只 征 在 测试 ， 
没有 做 其 他 事情 。 线 程 相关 代码 应 该 保持 短小 和 目的 集中 。 

了 解 并 发 问题 的 可 能 原因 : 对 共 至 数据 的 多 线程 操作 ， 或 使 用 了 
公共 资源 池 。 类 似 平静 关闭 或 停止 循环 之 类 边界 情况 尤其 坏 手 。 

学 习 类 库 ， 了 解 基本 算法 。 理 解 类 库 提 供 的 与 基础 算法 类 似 的 解 
决 问题 的 特性 。 

学 习 如 何 找到 必须 锁定 的 代码 区 域 并 山 定 之 。 不 要 锁定 不 必 锁 定 
的 代码 。 避 免 从 锁定 区 域 中 调用 其 他 锁定 区 域 。 这 需要 深刻 理解 某 物 
征 否 已 共享 。 尽 可 能 减少 共享 对 象 和 共 衬 范围 。 修 改 对 象 的 设计 ， 回 
客户 代码 提供 共 至 数据 ， 而 不 是 迫使 客户 代码 管理 共享 状态 。 

问题 会 跳出 来 。 那 种 在 早期 没 跳 出 来 的 问题 往往 是 偶发 的 。 这 种 
所 谓 偶发 问题 ， 通 常 仅 在 高 负载 下 出 现 或 者 偶然 出 现 。 所 以 ， 你 要 能 
在 不 同 平台 上 、 以 不 同 配置 持续 重复 运行 线程 代码 。 跟 随 TDD 三 要 则 
而 来 的 可 测试 性 意味 着 某 种 程度 的 可 插 拔 性 ， 从 而 提供 了 在 大 量 不 同 
配置 下 运行 代码 的 必要 支持 。 

如 果 伦 点 时 间 波 置 代码 ， 束 能 极 大 地 提升 发 现 错误 代码 的 机 会 。 
可 以 手工 做 ， 也 可 以 使 用 某 种 目 动 化 技术 。 尺 早 这 么 做 。 在 将 线程 代 
码 投入 生产 环境 前 ， 束 要 尽 可 能 多 地 运行 它 。 

只 要 采用 了 整洁 的 做 法 ， 做 对 的 可 能 性 束 有 翻天 覆 地 的 提高 。 
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他 的 原因 影响 。 
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对 一 个 命令 行 参数 解析 程序 的 案例 研究 


本 章 人 研究 一 个 逐步 改进 的 案例 。 你 将 看 到 一 个 开始 还 不 错 ， 规 模 
扩 天 后 即 出 问题 的 模块 。 你 还 将 看 到 这 个 模块 是 如 何 被 重 构 得 整 污 起 


来 的 。 

我 们 中 的 大 多 数 人 都 会 遇 到 解析 命令 行 参 数 的 情况 。 如 果 没 有 就 
手 的 工具 ， 就 得 遍历 传 入 main 函 数 的 字符 串 数组 。 有 一 些 不 同 来 源 的 
好 工具 ， 但 没有 一 个 是 最 符合 要 求 的 。 所 以 ， 我 当然 要 自己 写 一 个 。 
我 把 它 叫 做 Args。 

Args 非 常 易 于 使 用 。 你 只 要 简单 地 用 输入 参数 和 格式 化 字符 串 构 
造 Args 类 ， 再 向 Args 实 体 询问 参数 值 即 可 。 看 看 下 面 的 简单 例子 ; 

代码 清单 14-1 Args 的 简单 用 法 


public static void main(String[] args) 1 


try 1 
Argsarg = new Args("l,p#,d*", args); 
boolean logging = arg.getBoolean( 1); 
intport = arg.getInt('p'); 
Stringdirectory = arg.getString( d); 
executeA pplication(logging, port, directory); 
) catch (ArgsException e) 1 


System.out.printf("Argumenterror:%s\n", e.errorMessage()); 


} 

可 以 看 到 这 有 多 简单 。 我 们 只 是 用 两 个 参数 创建 了 Args 类 的 一 个 
实体 。 第 一 个 参数 是 格式 字符 串 ， 或 犯 式 字 符 串 : ],p#,d*。 它 定义 了 三 
数 。 第 一 个 ，-1， 是 一 个 布尔 值 参 数 。 第 二 个 ，-p， 是 一 个 
整数 参数 。 第 三 个 ，-d4， 是 一 个 字符 串 参 数 。 回 Args 构 造 锅 传 入 的 第 二 
个 参数 吏 是 同 main 传 入 的 命令 行 参数 数组 。 

如 果 构 造 器 正常 返回 ， 没 有 抛 出 ArgsException 异 常 ， 则 命令 行 参 
数 已 传 入 ，Args 实体 随时 待命 。 使 用 getBoolean 、getInteger 和 getString 
等 方法 ， 可 以 用 参数 名 称 获得 参数 值 。 
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ArgsException 异 常 。 可 以 从 该 异 


令 行 参数 出 现 问 题 ， 束 会 抛 出 一 个 
党 的 errorMessage 中 获得 天 于 错误 的 摘 


14.1 Args 的 实现 


代码 清单 14-2 是 Args 类 的 实现 。 请 仔细 阅读 。 我 在 代码 风格 和 结构 
上 人 花 了 大 力气 ， 使 之 值得 仿效 。 
代码 清单 14-2 Args.java 
package com.objectmentor.utilities.args; 
import static 
com.objectmentor.utilities.args. ArgsException.ErrorCode.*; 
import java.util.*; 
public class Args 1 
private Map<Character, ArgumentMarshaler> marshalers; 
private Set<Character> argsFound; 
private ListIterator<String> currentArgument; 
public Args(String schema, String[] args) throws ArgsException { 
marshalers = new HashMap<Character, ArgumentMarshaler>(); 
argsFound = new HashSet<Character>(); 
parseSchema(schema); 
parseArgumentStrings(Arrays.asList(args)); 
} 
private void parseSchema(String schema) throws ArgsException { 
for (String element : schema.split(",")) 


if (element.length() > 0) 


parseSchemaElement(element.trim()); 
} 
private void X parseSchemaElement(String element) throws 
ArgsException 1 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else if (elementTail.equals("[*]")) 
marshalers.put(elementId, new StringArray ArgumentMarshaler()); 
else 
throw new ArgsException(INVALID ARGUMENT FORMAT, 
elementId, elementTail); 
} 
private void  validateSchemaElementId(char elementld) throws 
ArgsException { 
if (!Character.isLetter(elementId)) 
throw new ArgsException(INVALID ARGUMENT NAME, 
elementId, null); 


} 


private void parseArgumentStrings(List<String> argsList) throws 
ArgsException 
{ 
for (currentArgument = argsList.listIterator(); 
currentArgument.hasNext();) 
{ 
String argString = currentArgument.next(); 
if (argString.startsWith("-")) { 
parseArgumentCharacters(argString.substring(1)); 
} else { 
currentArgument.previous(); 
break; 


} 
private void parseArgumentCharacters(String argChars) throws 
ArgsException { 
for (int i = 0; i < argChars.length(); i++) 
parseArgumentCharacter(argChars.charAt(i)); 
private void parseArgumentCharacter(char argChar) throws 
ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) { 
throw new ArgsException(UNEXPECTED ARGUMENT, 
argChar, null); 
} else 1 


argsFound.add(argChar); 

try 1 
m.set(currentArgument); 

) catch (ArgsException e) 1 
e.setErrorArgumentId(argChar); 


throw e; 


} 
public boolean has(char arg) { 
return argsFound.contains(arg); 
} 
public int nextArgument() { 
return currentArgument.nextIndex(); 
} 
public boolean getBoolean(char arg) { 
return BooleanArgumentMarshaler.get Value(marshalers.get(arg)); 
} 
public String getString(char arg) { 
return StringArgumentMarshaler. get Value(marshalers.get(arg)); 
} 
public int getInt(char arg) { 
return IntegerArgumentMarshaler.get Value(marshalers.get(arg)); 
} 
public double getDouble(char arg) { 


return DoubleArgumentMarshaler.get Value(marshalers.get(arg)); 


public String[] getStringArray(char arg) 1 
return 
StringArrayArgumentMarshaler.get Value(marshalers.get(arg)); 
} 
} 
注意 ， 你 可 以 从 上 到 下 阅读 这 些 代 码 ， 不 用 跳 来 跳 去 ， 也 不 用 先 
看 后 面 的 部 分 。 唯 一 需要 先 看 的 是 ArgumentMarshaler 的 定义 ， 这 部 分 
我 有 意 省 略 了 “。 仔 细 看 这 段 代 码 ， 你 应 该 能 理解 ArgumentMarshaler 接 
口 是 什 么 ， 其 派生 类 做 什么 。 下 面 我 将 向 你 展示 一 部 分 (如 代码 清单 
14-3 一 14-6 所 示 ) ° 
代码 清单 14-3 ArgumentMarshalerjava 


public interface ArgumentMarshaler { 


void set(Iterator<String> currentArgument) throws ArgsException; 
} 
代码 清单 14-4 BooleanArgumentMarshaler.java 
public Class BooleanArgumentMarshaler implements 
ArgumentMarshaler { 
private boolean booleanValue - false; 
public void set(Iterator<String> ^ currentArgument) throws 
ArgsException { 
boolean Value = true; 
} 
public static boolean getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof BooleanArgumentMarshaler) 
return ((BooleanArgumentMarshaler) am).boolean Value; 
else 


return false; 


} 
代码 清单 14-5 StringArgumentMarshaler.java 
import static 
com.objectmentor.utilities.args. ArgsException.ErrorCode.*; 
public class StringArgumentMarshaler implements ArgumentMarshaler 
private String string Value = ""; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
try { 
string Value = currentArgument.next(); 
} catch (NoSuchElementException e) { 
throw new ArgsException(MISSING_STRING); 


j 
public static String getValue(ArgumentMarshaler am) { 
if (am != null && am instanceof StringArgumentMarshaler) 
return ((StringArgumentMarshaler) am).stringValue; 
else 


nn", 


return  ; 


} 
代码 清单 14-6 Integer ArgumentMarshaler.java 
import static 


com.objectmentor.utilities.args. ArgsException.ErrorCode.*; 


public class IntegerArgumentMarshaler implements 
ArgumentMarshaler { 
private int intValue = 0; 
public void — set(Iterator<String> ^ currentArgument) throws 
ArgsException 1 
String parameter = null; 
try 1 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 
} catch (NoSuchElementException e) { 
throw new ArgsException(MISSING INTEGER); 
} catch (NumberFormatException e) { 
throw new ArgsException(INVALID INTEGER, parameter); 


} 
public static int get Value(ArgumentMarshaler am) { 
if (am != null && am instanceof IntegerArgumentMarshaler) 
return ((IntegerArgumentMarshaler) am).intValue; 
else 


return 0; 


} 
ArgumentMarshaler 的 其 他 派生 类 以 同样 的 模式 处 理 double 和 String 
级 组 一 一 列 出 反而 阻碍 行文 。 你 可 以 练习 目 己 实现 它们 。 
还 有 些 信息 可 能 会 困扰 你 : 错误 人 码 常 量 的 定义 。 这 些 是 在 
ArgsException 类 (代码 清单 14-7) 中 定义 的 。 
代码 清单 14-7 ArgsException.java 


import static 
com.objectmentor.utilities.args. ArgsException.ErrorCode.*; 
public class ArgsException extends Exception 1 
private char errorArgumentld = ^0'; 
private String errorParameter = null; 
private ErrorCode errorCode = OK; 
public ArgsException() {} 
public ArgsException(String message) { super(message); } 
public ArgsException(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public ArgsException(ErrorCode errorCode, String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
} 
public ArgsException(ErrorCode errorCode, 
char errorArgumentld,String 
errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentlId; 
} 
public char getErrorArgumentld() { 
return errorArgumentld; 
} 
public void setErrorArgumentId(char errorArgumentld) { 


this.errorArgumentId = errorArgumentlId; 


} 
public String getErrorParameter() 1 


return errorParameter; 
} 
public void setErrorParameter(String errorParameter) { 
this.errorParameter = errorParameter; 
} 
public ErrorCode getErrorCode() { 
return errorCode; 
} 
public void setErrorCode(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public String errorMessage() { 
switch (errorCode) { 
case OK: 
return "TILT: Should not get here."; 
case UNEXPECTED_ARGUMENT: 
return String.format("Argument -2%0C unexpected.", 
errorArgumentlId); 
case MISSING STRING: 
return String.format("Could not find string parameter for -%c.", 
errorArgumentld); 
case INVALID_INTEGER: 
return String.format("Argument -%c expects an integer but was 
'%0s'.", 


errorArgumentld, errorParameter); 


case MISSING INTEGER: 
return String.format("Could not find integer parameter for - 
%c.", 
errorArgumentld); 
case INVALID_DOUBLE: 
return String.format("Argument -%c expects a double but was 
'%s'.", 
errorArgumentld, errorParameter); 
case MISSING_DOUBLE: 
return String.format("Could not find double parameter for - 
%c.", 
errorArgumentld); 
case INVALID ARGUMENT NAME: 
return String.format(""96c' is not a valid argument name.", 
errorArgumentlId); 
case INVALID ARGUMENT FORMAT: 


return String.format("'%s' is not a valid argument format.", 


errorParameter); 
} 
return ""; 
} 
public enum ErrorCode { 
OK, INVALID ARGUMENT FORMAT, 


UNEXPECTED ARGUMENT, INVALID ARGUMENT NAME, 
MISSING. STRING, 
MISSING INTEGER, INVALID INTEGER, 
MISSING. DOUBLE, INVALID DOUBLE 


} 

为 了 充实 这 么 一 个 简单 概念 的 细节 ， 需 要 如 此 多 代码 ， 这 很 值得 
注意 。 原 因 之 一 是 我 们 使 用 了 Java 这 种 啼 叫 型 语言 。 作 为 一 种 静态 类 型 
语言 ， 需 要 大 量 语句 才能 满足 类 型 系统 的 要 求 。 在 Ruby、Python 或 
Smalltalk 等 语言 中 ， 程 序 会 短 很 多 [1] 。 

请 再 次 阅读 这 段 代 码 。 特 别 留 意 命 名 方式 、 函 数 大 小 和 代码 格 
式 。 如 采 你 是 经 验 丰 富 的 程序 员 ， 可 能 会 对 风格 或 结构 有 着 这 样 或 那 
样 的 不 同 观 点 。 不 过 ， 和 硕 望 你 认为 这 段 程序 总 体 上 编写 良好 ， 有 着 整 
洁 的 结构 © 

例如 ， 如 何 增加 新 参数 类 型 ， 如 日 期 或 复杂 数字 参数 。 其 实现 手 
段 很 清楚 ， 而 且 只 需要 花 一 点 点 力气 即 可 。 简 言 之 ， 只 需要 从 
ArgumentMarshaler Jk È — #1 È, 5 — ^ 3 HJ getXXX HAL, TE 
parseSchemaElement 函数 中 添加 一 个 新 的 case 语句 。 可 能 还 需要 添加 新 
的 ArgsException.Errorcode 和 新 错误 信息 。 

RE Z TET 

先 放松 一 下 神经 。 这 上 段 程序 并 非 从 一 开始 就 写成 现在 的 样子 。 更 
重要 的 是 ， 我 也 没 指望 你 能 够 一 次 过 写 出 整洁 、 漂 亮 的 程序 。 如 采 说 
我 们 从 过 去 几 十 年 里 面 学 到 什么 东西 的 话 ， 那 就 是 编程 是 一 种 拉 万 其 
于 科学 的 东西 。 要 编写 整洁 代码 ， 必 须 移 写 脐 脏 代码 ， 然 后 再 清理 
它 。 

你 应 该 不 会 对 此 感到 司 讶 。 我 们 在 小 学 就 学 过 这 条 真理 了 。 那 
上 时， 老师 (通常 是 徒劳 地 ) 努力 让 我 们 写作 文 草稿 。 他 们 告诉 我 们 ， 
我 们 应 该 先 写 草 稿 ， 再 写 二 稿 ， 一 次 义 一 次 地 草 毛 ， 直 人 至 写 出 终 稿 。 
他 们 尽力 告诉 我 们 ， 写 出 好 作文 是 一 个 逐步 改进 的 过 程 。 

多 数 新 手 程序 员 (就 像 多 数 小 学 生 一 样 ) 没有 特别 认真 地 遵循 这 
个 建议 。 他 们 相信 ， 首 要 任务 是 写 出 能 工作 的 程序 。 只 要 程序 “能 工 
作 ”， 就 转移 到 下 一 个 任务 上 ， 而 那个 “能 工作 ”的 程序 就 留 在 了 最 后 那 


个 所 谓 “ 能 工作 ”的 状态 。 多 数 老手 程序 员 都 知道 ， 这 是 一 种 自 毁 行 
为 。 


14.2 Args: 草稿 


代码 清单 14-8 展 示 了 Args 类 的 一 个 早期 版 本 。 它 “能 工作 ”， 但 却 很 


jp 


代码 清单 14-8 Args.java (初稿 ) 
import java.text.ParseException; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 
private boolean valid = true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 


new HashMap<Character, Boolean>(); 


private Map<Character, String> stringArgs = new 
HashMap<Character, String>(); 
private Map<Character, Integer> intArgs = new 


HashMap<Character, Integer>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgumentId = ^0'; 


private String errorParameter = "TILT"; 


private ErrorCode errorCode = ErrorCode.OK; 
private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
this.args = args; 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
return valid; 
} 
private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement = element.trim(); 


parseSchemaElement(trimmedElement); 


} 


return true; 


} 
private void parseSchemaElement(String element) throws 
ParseException 1 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
parseBooleanSchemaElement(elementId); 
else if (isStringSchemaElement(elementTail)) 
parseStringSchemaElement(elementId); 
else if (isIntegerSchemaElement(elementTail)) { 
parseIntegerSchemaElement(elementId); 
} else { 
throw new ParseException 
(String.format("Argument: %c has invalid format: %s.", 


elementId,elementTail),0); 


} 
private void validateSchemaElementId(char elementId) throws 
ParseException { 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 


"Bad character:"+elementId+"in Args format: "+schema,0); 


} 


private void parseBooleanSchemaElement(char elementId) { 


booleanArgs.put(elementld, false); 


} 


private void parseIntegerSchemaElement(char elementId) { 
intArgs.put(elementld, 0); 

} 

private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementld, ""); 

} 

private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 

} 

private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 

} 

private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 

i 

private boolean parseArguments() throws ArgsException { 
for (currentArgument = 0; currentArgument < args.length; 

currentArgument++) { 
String arg = args[currentArgument]; 
parseArgument(arg); 

} 
return true; 

} 

private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 


parseElements(arg); 


} 


private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode = ErrorCode. UNEXPECTED ARGUMENT; 


valid = false; 


} 


private boolean setArgument(char argChar) throws ArgsExceptio 
if (isBooleanArg(argChar)) 
setBooleanArg(argChar, true); 
else if (isStringArg(argChar)) 
setStringArg(argChar); 
else if (isIntArg(argChar)) 
setIntArg(argChar); 
else 
return false; 
return true; 
} 
private boolean isIntArg(char argChar) 
intArgs.containsKey(argChar); } 


ni 


{return 


private void setIntArg(char argChar) throws ArgsException 1 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.put(argChar, new Integer(parameter)); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
valid = false; 
errorArgumentId = argChar; 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID_INTEGER; 


throw new ArgsException(); 


} 
private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 
try { 
stringArgs.put(argChar, args[currentArgument]); 
} catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
private boolean isStringArg(char argChar) { 
return stringArgs.containsKey(argChar); 
} 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
} 
private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 


return unexpectedArgumentMessage(); 


case MISSING STRING: 
return String.format("Could not find string parameter for - 
%c.", 
errorArgumentlId); 
case INVALID INTEGER: 
return String.format(" Argument -%c expects an integer but 
was '96s'.", 
errorArgumentld, errorParameter); 
case MISSING INTEGER: 
return String.format(" Could not find integer parameter for -%c.", 
errorArgumentlId); 
} 


return ; 


private String unexpectedArgumentMessage() 1 


} 


StringBuffer message = new StringBuffer(" Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
} 
message.append(" unexpected."); 


return message.toString(); 


private boolean falseIfNull(Boolean b) { 


} 


return b != null && b; 


private int zeroIfNull(Integer i) { 


return i == null ? 0 : i; 


} 


private String blankIfNull(String s) { 


return s == null ? "" : s; 


} 


public String getString(char arg) { 


return blankIfNull(stringArgs.get(arg)); 


j 
public int getInt(char arg) 1 


return zeroIfNull(intArgs.get(arg)); 


} 


public boolean getBoolean(char arg) { 


return falseIfNull(booleanArgs.get(arg)); 


} 
public boolean has(char arg) { 


return argsFound.contains(arg); 


} 
public boolean isValid() { 


return valid; 


} 


private class ArgsException extends Exception { 


} 
} 


希望 你 看 到 这 段 乱 七 八 粳 的 代码 时 ， 第 一 反应 是 “他 没 就 此 要 手 ， 


真 令 人 高 兴 ! ”如 有 果 你 这 么 想 ， 不 如 
代码 的 想法 吧 。 


相 相 其 
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他 人 对 你 留置 在 草稿 形态 的 


实际 上 , “草稿 ”大概 会 是 你 对 这 段 代码 的 最 高 评价 。 它 显然 还 需 
打 麻 。 实 体 变量 的 数量 多 到 吓人 。 诸 如 TILT 之 类 奇怪 的 字符 串 ， 


HashSet 和 TreeSets， 还 有 那些 try-catch-catch 代 码 块 ， 组 成 了 一 个 烂 摊 
子 。 
我 不 想 写 出 一 个 烂摊子 。 我 也 一 直 想 保持 一 切 有 序 。 从 函数 和 变 
量 命 名 ， 以 及 程序 的 粗略 架构 中 ， 你 可 以 看 出 这 一 点 。 不 过 ， 显 然 我 
没 能 做 到 。 
混乱 是 逐渐 产生 的 。 更 早 的 版 本 并 不 如 此 脐 脏 。 例 如 ， 代 码 清单 
14-9 展 示 了 一 个 早期 版 本 代码 ， 那 时 只 支持 Boolean 参 数 。 
代码 清单 14-9 Args.java 《只 支持 Boolean) 
package com.objectmentor.utilities.getopts; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 
private boolean valid; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 
private int numberOfArguments = 0; 
public Args(String schema, String[] args) { 
this.schema = schema; 
this.args = args; 
valid = parse(); 
} 
public boolean isValid() { 


return valid; 


private boolean parse() 1 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
parseArguments(); 
return unexpectedArguments.size() == 0; 
} 
private boolean parseSchema() { 
for (String element : schema.split(",")) { 
parseSchemaElement(element); 
return true; 
} 
} 
private void parseSchemaElement(String element) { 
if (element.length() == 1) { 


parseBooleanSchemaElement(element); 


} 
private void parseBooleanSchemaElement(String element) { 
char c = element.charAt(0); 
if (Character.isLetter(c)) { 
booleanArgs.put(c, false); 


} 
private boolean parseArguments() { 
for (String arg : args) 


parseArgument(arg); 


return true; 
} 
private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
Í 
private void parseElement(char argChar) { 
if (isBoolean(argChar)) { 
numberOfArguments++; 
setBooleanArg(argChar, true); 
} else 
unexpectedArguments.add(argChar); 
} 
private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 
j 
private boolean isBoolean(char argChar) 1 
return booleanArgs.containsKey(argChar); 
} 
public int cardinality() { 
return numberOfArguments; 
} 
public String usage() { 


if (schema.length() > 0) 
return "-[" + schema + "]"; 

else 
return "5 

} 
public String errorMessage() { 

if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage(); 

} else 
return ""; 

} 

private String unexpectedArgumentMessage() 1 
StringBuffer message = new StringBuffer(" Argument(s) -"); 
for (char c : unexpectedArguments) { 

message.append(c); 

} 
message.append(" unexpected."); 
return message.toString(); 

} 

public boolean getBoolean(char arg) { 
return booleanArgs.get(arg); 


} 


} 
尽管 你 可 能 对 这 段 代 码 很 不 满意 ， 其 实 它 并 非 如 此 之 烂 。 它 精 
简单 ， 易 于 理解 。 然 而 ， 在 这 段 代码 中 很 容易 找到 后 面 烂 摊子 的 


A] 


根源 。 很 清楚 能 看 到 小 问题 如 何 变 成 大 混乱 的 。 


注意 ， 后 来 的 混乱 代码 只 比 这 个 版 本 多 文 持 两 种 参数 类 型 : String 
和 integer。 只 增加 两 种 参数 类 型 支持 ， 束 对 代码 产生 了 如 此 巨大 的 负面 
影 啊 。 它 从 某 种 可 维护 之 物 变 成 了 满 是 缺陷 的 东西 。 

我 逐步 添加 了 对 这 两 种 参数 类 型 的 文 持 。 百 爷 ， 我 添加 对 String 参 
BITS, PIRATE: 

代码 清单 14-10 Args.java (Boolean 和 String) 


package com.objectmentor.utilities.getopts; 


import java.text.ParseException; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 
private boolean valid - true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, Boolean> booleanArgs = 
new HashMap<Character, Boolean>(); 
private Map<Character, String> stringArgs = 
new HashMap<Character, String>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgument = ^0*; 
enum ErrorCode { 
OK, MISSING_STRING} 
private ErrorCode errorCode = ErrorCode.OK; 
public Args(String schema, String[] args) throws ParseException { 


this.schema = schema; 


this.args — args; 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
parseArguments(); 
return valid; 
} 
private boolean parseSchema() throws ParseException { 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement - element.trim(); 


parseSchemaElement(trimmedElement); 


} 


return true; 


} 


private void parseSchemaElement(String ^ element) 


ParseException 1 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
parseBooleanSchemaElement(elementId); 


else if (isStringSchemaElement(elementTail)) 


throws 


parseStringSchemaElement(elementId); 
j 
private void validateSchemaElementId(char elementId) throws 
ParseException { 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 


"Bad character:" + elementId + "in Args format: " + schema, 0); 


} 

private void parseStringSchemaElement(char elementId) { 
stringArgs.put(elementld, ""); 

} 

private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 

} 

private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 

} 

private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementld, false); 

} 


private boolean parseArguments() { 


for (currentArgument = 0; currentArgument < args.length; 
currentArgument++) 
{ 


String arg = args[currentArgument]; 


parseArgument(arg); 


} 
return true; 
} 
private void parseArgument(String arg) { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 


valid = false; 


} 


private boolean setArgument(char argChar) { 
boolean set = true; 
if (isBoolean(argChar)) 
setBooleanArg(argChar, true); 
else if (isString(argChar)) 
setStringArg(argChar, ""); 
else 


set = false; 


return set; 
} 
private void setStringArg(char argChar, String s) { 
currentArgument++; 
try { 
stringArgs.put(argChar, args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgument = argChar; 
errorCode = ErrorCode. MISSING. STRING; 


} 

private boolean isString(char argChar) { 
return stringArgs.containsKey(argChar); 

} 

private void setBooleanArg(char argChar, boolean value) { 
booleanArgs.put(argChar, value); 

} 

private boolean isBoolean(char argChar) { 
return booleanArgs.containsKey(argChar); 

} 

public int cardinality() { 
return argsFound.size(); 

} 

public String usage() { 
if (schema.length() > 0) 


return "-[" + schema + "]"; 


else 


n", 


return ; 
} 
public String errorMessage() throws Exception { 
if (unexpectedArguments.size() > 0) { 
return unexpectedArgumentMessage(); 
} else 
switch (errorCode) { 
case MISSING_STRING: 


return String.format("Could not find string parameter for - 


%c.", 
errorArgument); 
case OK: 
throw new Exception(" TILT: Should not get here."); 
} 
return ""; 


} 

private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer(" Argument(s) -"); 
for (char c : unexpectedArguments) { 

message.append(c); 

} 
message.append(" unexpected. "); 
return message.toString(); 

} 

public boolean getBoolean(char arg) { 
return falseIfNull(booleanArgs.get(arg)); 


j 
private boolean falseIfNull(Boolean b) 1 


return b == null ? false : b; 


public String getString(char arg) 1 
return blankIfNull(stringArgs.get(arg)); 
} 
private String blankIfNull(String s) { 
return s == null ? "" : s; 
} 
public boolean has(char arg) { 
return argsFound.contains(arg); 
} 
public boolean isValid() { 


return valid; 


} 

你 可 以 看 到 ， 代 码 开始 失去 控制 。 还 算 不 上 可 怕 ， 但 混乱 已 经 开 
始 生 长 。 已 经 出 现 了 一 堆 东 西 ， 不 过 还 没 粒 挥 。 增 加 对 整数 参数 类 型 
的 文 持 后 ， 那 堆 东西 就 真 的 变质 腐烂 了 


14.2.1 所 以 我 暂停 了 


DA BD MMS MAH BSI, MARES BOER o WFR 
一 味 蛋 干 ， 大 概 也 能 让 它 工 作 ， 不 过 束 会 留 下 一 大 堆 要 调整 的 混乱 。 
如 琳 布 望 代码 结构 一 直 可 维护 ， 现 在 整 古 调整 的 时 机 了 。 


所 以 我 暂停 添加 特性 ， 开 始 重 构 。 由 于 刚 添 加 了 String 和 integer 参 
数 ， 我 知道 每 种 参数 类 型 都 需要 在 三 个 主要 位 置 增加 新 代码 。 首 先 ， 
每 种 参数 类 型 都 要 有 解析 其 范式 元 素 、 从 而 为 该 种 类 型 选择 HashMap 
的 方法 。 其 次 ， 每 种 参数 类 型 都 需要 在 命令 行 字 符 串 中 解析 ， 然 后 再 
转换 为 真实 类 型 。 最 后 ， 每 种 参数 类 型 都 需要 一 个 getXXX 方 法 ， 按 照 
其 真实 类 型 回调 用 者 返回 参数 值 。 

许多 种 不 同类 型 ， 类 似 的 方法 ——UrpEBoK RIETI 
ArgumentMarshaler 的 概念 就 是 这 样 产 生 的 。 


14.2.2 渐进 


毁坏 程序 的 最 好 方法 之 一 就 是 以 改进 之 名 大 动 其 结构 。 有 些 程序 
永远 不 能 从 这 种 所 谓 “ 改 进 ” 中 恢复 过 来 。 问 题 在 于 ， 很 难 让 程序 以 “ 改 
进 ” 之 前 的 方式 工作 。 

为 了 避免 这 种 状况 发 生 ， 我 采用 了 测试 驱动 开发 的 规程 。 这 种 手 
法 的 核心 原则 之 一 是 保持 系统 始终 能 运行 。 换 言 之 ,采用 TDD， 我 不 
会 允许 做 出 破坏 系统 的 修改 。 每 次 修改 都 必须 保证 系统 能 像 以 前 一 样 
LIF © 

我 需要 一 套 能 随 需 运行 、 确 保 系统 行为 不 会 改动 的 自动 化 测试 。 
在 我 搞 出 那个 烂摊子 的 同时 ， 也 为 Args 类 创建 了 一 套 单 元 测试 和 验收 
测试 。 蛙 元 测试 用 Java 写 成 ， 采 用 JUnit 管 理 。 验 收 测 试用 FitNesse 以 
wiki 页 形式 写成 。 我 可 以 随时 运行 这 些 测试 ， 如 采 测 试 通过 ， 束 能 打包 
票 说 系统 以 我 期 望 的 方式 工作 。 

于 是 我 开始 做 出 大 量 小 规模 修改 。 每 次 修改 都 将 系统 结构 辣 
ArgumentMarshaler 概念 的 方向 推动 。 而 且 每 次 修改 后 ， 系 统 都 要 能 工 
作 。 第 一 个 修改 是 在 烂摊子 末尾 添加 ArgumentMarshaler 的 轮廓 。 

代码 清单 14-11 向 Args.java 添 加 ArgumentMarshaler 


private class ArgumentMarshaler { 
private boolean boolean Value = false; 
public void setBoolean(boolean value) { 


booleanValue = value; 


j 

public boolean getBoolean() {return boolean Value; } 

} 

private class BooleanArgumentMarshaler extends 


ArgumentMarshaler { 
} 


private class StringArgumentMarshaler extends ArgumentMarshaler 


{ 
} 
private class IntegerArgumentMarshaler extends ArgumentMarshaler 
{ 
} 
} 


显然 ， 这 什么 也 不 会 破坏 。 于 是 我 做 了 一 后 最 简单 的 、 破 坏 性 尽 
可 能 小 的 修改 。 我 修改 了 HashMap ， 采 用 ArgumentMarshaler ， 使 之 文 
持 Boolean 参 数 。 

private Map<Character, ArgumentMarshaler> booleanArgs = 


new HashMap<Character, ArgumentMarshaler>(); 


这 个 修改 影响 到 少数 语句 ， 我 很 快 承 修正 了 。 


private void parseBooleanSchemaElement(char elementId) { 
booleanArgs.put(elementId, new BooleanArgumentMarshaler()); 


} 


private void setBooleanArg(char argChar, boolean value) 1 
booleanArgs.get(argChar).setBoolean(value); 
j 


public boolean getBoolean(char arg) 1 

return falseIfNull(booleanArgs.get(arg).getBoolean()); 

j 

注意 ， 这 些 修改 正 是 在 我 之 前 提 到 的 那些 区 域 之 内 所 做 的 : 参数 
类 型 的 parse、set 和 和 get 操作。 不 下 的 是 ， 即 便 修 改 如 此 细微 ， 有 些 测试 

是 会 失败 。 仔 细 看 getBoolean， 可 以 看 到 如 果 用 y 去 调用 、 bai 

XBL, J! booleanArgs.get(‘y') #i A 3x [Al null E, HAM 
NullPointerException = » EX Zi falseIfNull H ELE; LE PRR AE , o H 
我 做 出 的 修改 却 导 致 该 函数 无 所 作为 。 

渐进 主义 要 求 我 在 做 其 他 修改 之 前 迅速 修正 这 个 问题 。 修 正 并 不 
费劲 。 我 只 是 把 对 null 值 的 检查 移 了 个 位 置 。 再 也 不 用 检测 bollean 是 否 
为 null， 而 是 检查 ArgumentMarshaler 是 否 为 null ° 

首先 ， 我 移 除 了 getBoolean 函 数 中 的 falseIfNull 调 用 。 现 在 它 没什么 
用 了 ， 所 以 我 也 删 去 了 这 个 函数 。 测 试 还 是 以 同样 的 方式 失败 ， 所 以 
我 确定 没有 引入 新 的 错误 。 


public boolean getBoolean(char arg) 1 


return booleanArgs.get(arg).getBoolean(); 
j 
下 一 步 ， 我 把 函数 拆 解 为 两 行 ， 并 把 ArgumentMarshaler 放 到 它 目 
己 的 名 ee Cd 量 中 [2]。 我 不 在 意 变量 名 太 长 ， 但 它 
却 有 所 哆 唆 ， 把 芳 数 捅 得 文 离 破 肆 。 所 以 我 把 变量 名 缩短 为 am[N5]。 
public boolean getBoolean(char arg) { 


Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am.getBoolean(); 

j 

然后 再 放 入 检测 null 值 的 逻辑 。 

public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 


return am != null && am.getBoolean(); 


14.3 


S 


添加 String 参 数 和 添加 boolean 参 数 非常 像 。 我 要 修改 HashMap， 让 
parse、set 和 get 芳 数 能 工作 。 跟 着 就 是 按部就班 ， 但 我 似乎 该 把 所 有 的 
marshalling (编组 实现 放 到 ArgumentMarshaler 基 类 而 不 是 派生 类 中 。 

private Map<Character, ArgumentMarshaler> stringArgs = 


new HashMap<Character, ArgumentMarshaler>(); 


private void parseStringSchemaElement(char elementId) { 


stringArgs.put(elementId, new StringArgumentMarshaler()); 


private void setStringArg(char argChar) throws ArgsException { 
currentArgument++; 


try { 
stringArgs.get(argChar).setString(args[currentArgument]); 


} catch (ArrayIndexOutOfBoundsException e) { 


valid = false; 
errorArgumentld = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 


return am == null ? "" : am.getString(); 


private class ArgumentMarshaler { 
private boolean booleanValue = false; 
private String stringValue; 

public void setBoolean(boolean value) { 
boolean Value = value; 

} 

public boolean getBoolean() { 
return boolean Value; 

j 

public void setString(String s) { 
stringValue - s; 

} 

public String getString() { 
return stringValue == null ? "" : stringValue; 


} 


} 

同样 ， 也 是 每 次 修改 一 个 地 方 ， 持 续 运 行 测试 。 如 果 测 斌 出错， 
在 做 下 一 个 修改 前 确保 通过 。 

现在 你 应 该 明白 我 的 意图 了 。 一 旦 我 将 当前 的 编组 行为 放 到 
ArgumentMarshaler 基 类 中 ， 就 会 开始 往 派 生 类 推 入 该 行为 。 这 样 ， 在 
我 逐渐 修改 程序 的 形状 时 ， 还 能 保持 一 切 正 常 。 

下 一 步 显 而 易 见 ， 把 int 参 数 的 相关 功能 放 到 ArgumentMarshaler 里 
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private Map<Character, ArgumentMarshaler> intArgs = 


new HashMap<Character, ArgumentMarshaler>(); 


private void parseIntegerSchemaElement(char elementId) { 


intArgs.put(elementId, new IntegerArgumentMarshaler()); 


private void setIntArg(char argChar) throws ArgsException 1 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.get(argChar).setInteger(Integer.parseInt(parameter)); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 


} catch (NumberFormatException e) 1 


valid = false; 

errorArgumentId = argChar; 

errorParameter = parameter; 

errorCode = ErrorCode.INVALID INTEGER; 


throw new ArgsException(); 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 


return am == null ? 0 : am.getInteger(); 


private class ArgumentMarshaler { 

private boolean boolean Value = false; 

private String string Value; 

private int integerValue; 

public void setBoolean(boolean value) { 
booleanValue = value; 

} 

public boolean getBoolean() { 
return boolean Value; 

} 

public void setString(String s) { 
string Value = s; 

} 

public String getString() { 


return stringValue —- null ? "" : stringValue; 


public void setInteger(int i) ( 


integerValue - i; 


public int getInteger() ( 


return integerValue; 


} 

当 所 有 的 编组 操作 都 放 到 了 ArgumentMarshaler"P, ， 我 开始 向 派生 
类 移植 功能 。 第 一 步 是 把 setBoolean 函 数 放 到 BooleanArgumentMarshaler 
中 ， 确 保 它 能 正确 调用 。 所 以 我 创建 了 一 个 抽象 的 set 方 法 。 


private abstract class ArgumentMarshaler { 


protected boolean booleanValue = false; 
private String stringValue; 
private int integerValue; 
public void setBoolean(boolean value) { 
booleanValue - value; 
} 
public boolean getBoolean() { 
return boolean Value; 
} 
public void setString(String s) { 
string Value = s; 
} 
public String getString() { 


return string Value == null ? "" : string Value; 


} 
public void setInteger(int i) { 
integer Value = i; 
} 
public int getInteger() { 
return integer Value; 
} 
public abstract void set(String s); 
} 
然后 在 BooleanArgumentMarshaler 中 实现 set 方 法 。 


private class BooleanArgumentMarshaler extends ArgumentMarshaler 


public void set(String s) { 


booleanValue - true; 


} 

最 后 ， 通 过 调用 set， 替 换 对 setBoolean 的 调用 © 

private void setBooleanArg(char argChar, boolean value) 1 

booleanArgs.get(argChar).set(" true"); 

} 

测试 仍然 全 部 通过 。 因 为 这 次 修改 导致 st 函数 放 到 了 
ii 面 ， 我 就 从 ArgumentMarshaler 基 类 删除 了 
setBoolean 方 法 。 

注意 ， HR KA set 有 一 个 String 参数 ， 但 其 在 
BooleanArgumentMarshaler 中 的 实现 却 没有 使 用 这 个 参数 。 之 所 以 在 这 
里 放 个 参数 ， 是 因为 我 知道 ”StringArgumentMarshaler 和 
IntegerArgumentMarshaler 可 能 会 使 用 它 


跟着 ， 我 打算 把 get 方 法 放 到 BooleanArgumentMarshaler 中 。 这 有 点 
难看 ， 因 为 返回 类 型 必须 是 Object， 且 在 这 里 需要 转换 为 Boolean 值 。 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am != null && (Boolean)am.get(); 
} 
为 了 编译 通过 ， 我 把 get 函 数 加 到 ArgumentMarshaler 中 。 


private abstract class ArgumentMarshaler 1 


public Object get() { 


return null; 


} 

这 样 一 来 ， 虽 然 可 以 编译 ， 但 却 无 法 通过 测试 。 只 要 将 get 修改 为 
抽象 方法 ， 并 在 BooleanArgumentMarshaler 中 实现 ， 就 能 重新 通过 测 
piu 


private abstract class ArgumentMarshaler 1 


protected boolean booleanValue - false; 


public abstract Object get(); 
} 
private class BooleanArgumentMarshaler extends 
ArgumentMarshaler { 
public void set(String s) { 
boolean Value = true; 
} 
public Object get() { 


return boolean Value; 


} 

测试 又 通过 了 。get 和 set 方法 都 已 部 署 到 BooleanArgumentMarshaler 
中 ! 这 样 我 就 可 以 从 ArgumentMarshaler 里 面 移 除 旧 的 getBoolean 函 数 ， 
把 受 保 护 的 booleanValue 变 量 癌 下 移动 到 BooleanArgumentMarshaler， 并 
将 其 设置 为 private © 

对 于 String 也 照 此 办 理 。 我 修改 了 set 和 get 的 部 署 方式 ， 删 除 无 用 的 
函数 ， 并 移动 了 变量 。 

private void setStringArg(char argChar) throws ArgsException { 


currentArgument++; 
try { 
stringArgs.get(argChar).set(args[currentArgument]); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
public String getString(char arg) { 
Args.ArgumentMarshaler am = stringArgs.get(arg); 


return am == null ? "" : (String) am.get(); 


private abstract class ArgumentMarshaler { 


private int integerValue; 

public void setInteger(int i) 1 
integerValue = i; 

} 

public int getInteger() { 
return integer Value; 

} 

public abstract void set(String s); 

public abstract Object get(); 


private class BooleanArgumentMarshaler extends ArgumentMarshaler 


private boolean booleanValue = false; 

public void set(String s) { 
booleanValue = true; 

j 

public Object get() { 


return boolean Value; 


} 
private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String stringValue = ""; 
public void set(String s) { 
stringValue = s; 
} 
public Object get() { 


return stringValue; 


} 
private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
public void set(String s) { 
} 
public Object get() { 
return null; 


} 


最 后 ， 我 为 integer I 。 这 稍稍 复杂 一 点 ， 
为 integer 需要 解析 ， 而 parse 操作 会 抛 出 异常 。 不 过 结果 会 更 好 ， Ed 
NumberFormatException 的 概念 在 NONE dE 
private boolean isIntArg(char argChar) - 
intArgs.containsKey(argChar); } 
private void setIntArg(char argChar) throws ArgsException { 
currentArgument++; 
String parameter = null; 
try { 
parameter = args[currentArgument]; 
intArgs.get(argChar).set(parameter); 
) catch (ArrayIndexOutOfBoundsException e) { 
valid = false; 
errorArgumentId = argChar; 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 


} catch (ArgsException e) 1 


valid = false; 

errorArgumentld = argChar; 

errorParameter = parameter; 

errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


private void setBooleanArg(char argChar) { 
try { 
booleanArgs.get(argChar).set("true"); 
} catch (ArgsException e) { 
} 


public int getInt(char arg) { 
Args.ArgumentMarshaler am = intArgs.get(arg); 


return am == null ? 0 : (Integer) am.get(); 


private abstract class ArgumentMarshaler { 
public abstract void set(String s) throws ArgsException; 


public abstract Object get(); 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 1 


private int intValue - 0; 


public void set(String s) throws ArgsException { 
try 1 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) { 
throw new ArgsException(); 


} 


public Object get() { 


return int Value; 


} 
测试 当然 继续 通过 。 ， 我 要 删 掉 算法 顶端 的 三 种 不 同 Map 。 
这 样 ， 整 个 系统 就 变 得 更 ; e AN, PS 它们 却 无 法 达到 目 
的 ， 因 为 那样 会 破坏 系统 。 反 之 ， 我 为 ArgumentMarshaler 添 加 一 个 新 
的 Map， 然 后 再 逐个 修改 那些 方法 ， 让 方法 调用 这 个 新 Map。 
public class Args 1 


private Map«Character, ArgumentMarshaler> booleanArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> stringArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


private void parseBooleanSchemaElement(char elementId) { 


ArgumentMarshalerm - new BooleanArgumentMarshaler(); 
booleanArgs.put(elementId, m); 
marshalers.put(elementId, m); 
} 
private void parseIntegerSchemaElement(char elementId) { 
ArgumentMarshaler m - new IntegerArgumentMarshaler(); 
intArgs.put(elementId, m); 
marshalers.put(elementId, m); 
} 
private void parseStringSchemaElement(char elementId) { 
ArgumentMarshaler m = new StringArgumentMarshaler(); 
string Args.put(elementld,m); 
marshalers.put(elementId, m); 
} 
当然 ， 测 试 还 是 通过 了 。 接 着 ， 我 把 isBooleanArg: 
private boolean isBooleanArg(char argChar) { 
return booleanArgs.containsKey(argChar); 
} 
修改 成 这 样 : 
private boolean isBooleanArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof BooleanArgumentMarshaler; 
} 
测试 仍然 通过 。 于 是 我 修改 了 一 下 isIntArg 和 isStringArg。 
private boolean isIntArg(char argChar) { 
ArgumentMarshaler m - marshalers.get(argChar); 


return m instanceof IntegerArgumentMarshaler; 


} 
private boolean isStringArg(char argChar) { 
ArgumentMarshaler m = marshalers.get(argChar); 
return m instanceof StringArgumentMarshaler; 
} 
测试 继续 通过 。 我 跟着 消除 了 对 marshaler.get 的 重复 调用 : 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (isBooleanArg(m)) 
setBooleanArg(argChar); 
else if (isStringArg(m)) 
setStringArg(argChar); 
else if (isIntArg(m)) 
setIntArg(argChar); 
else 
return false; 
return true; 
} 
private boolean isIntArg(ArgumentMarshaler m) { 
return m instanceof IntegerArgumentMarshaler; 
} 
private boolean isStringArg(ArgumentMarshaler m) { 
return m instanceof StringArgumentMarshaler; 
} 
private boolean isBooleanArg(ArgumentMarshaler m) { 


return m instanceof BooleanArgumentMarshaler; 


FFE = TisxxxArg h REE o Pro EA T ABER: 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(argChar); 
else if (m instanceof String ArgumentMarshaler) 
setStringArg(argChar); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(argChar); 
else 
return false; 
return true; 
} 
下 一 步 ， 我 开始 在 set 函 数 中 使 用 marshaler 映 射 ， 停 止 使 用 另外 三 
PRR ETEREY © MbooleanFF 4A: 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof String ArgumentMarshaler) 
setStringArg(argChar); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(argChar); 
else 
return false; 


return true; 


private void setBooleanArg( ArgumentMarshaler m) { 
try 1 
m.set(" true"); // was: booleanArgs.get(argChar).set("true"); 
} catch (ArgsException e) 1 
j 
} 
测试 通过 ， 于 是 我 如 法 炮制 String 和 Integer 参 数 。 这 样 我 就 能 把 有 
EE TL BEES RES E TETUR SE T SlsetArgumentER ZA rH. » 
private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m = marshalers.get(argChar); 
try 1 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
else 
return false; 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 


return true; 


private void setIntArg( ArgumentMarshaler m) throws ArgsException 1 
currentArgument++; 

String parameter = null; 

try { 
parameter = args[currentArgument]; 
m.set(parameter); 

) catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 

) catch (ArgsException e) 1 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


} 
private void — setStringArg(ArgumentMarshaler | m) throws 
ArgsException { 
currentArgument++; 
try { 
m.set(args[currentArgument]); 
} catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode.MISSING_STRING; 


throw new ArgsException(); 


} 
离 彻 底 删 除 那 3 个 旧 映 射 的 时 机 越 来 越 近 了 。 首 先 ， 我 需要 修改 
getBooleanPK&X: 


public boolean getBoolean(char arg) 1 
Args.ArgumentMarshaler am = booleanArgs.get(arg); 
return am != null && (Boolean) am.get(); 

j 

修改 成 这 样 : 

public boolean getBoolean(char arg) { 

Args.ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 

try { 

b = am !- null && (Boolean) am.get(); 

} catch (ClassCastException e) 1 


b - false; 
j 
return b; 
j 


最 后 这 个 修改 可 能 令 人 上 吃惊。 为 什么 我 会 突然 决定 对 付 
ClassCastException? 原因 是 我 有 一 组 单元 测试 ， 还 有 用 FitNesse 编 写 的 
一 组 验收 测试 。FitNesse 测 斌 确认 ， 如 采用 非 布 尔 值 参 数 调 用 
getBoolean， 应 该 返回 false。 可 单元 测试 的 结果 不 是 这 样 。 而 到 此 时 为 
IE, 我 一 直 只 调用 单元 测试 [3] 。 

这 次 修改 把 另 一 个 对 boolean 映 射 的 使 用 抽 离 了 : 


private void parseBooleanSchemaElement(char elementId) { 


ArgumentMarshaler m = new BooleanArgumentMarshaler(); 


marshalers.put(elementId, m); 


如 此 我 们 就 能 删除 boolean 映 射 。 
public class Args { 


——private—Map«Charaeter;,—ÁArgumentMarshaler»— booleanArgs—- 
new_HashMap<Character_— ArgumentMarshaler>{}-- 


private Map<Character, ArgumentMarshaler> stringArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> intArgs = 
new HashMap<Character, ArgumentMarshaler>(); 

private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


接 下 来 ， 我 用 同样 的 手法 处 理 String 和 Integer 参 数 ， 对 boolean 人 参数 
做 了 一 点 清理 工作 。 

private void parseBooleanSchemaElement(char elementId) { 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 

} 

private void parseIntegerSchemaElement(char elementId) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 

} 

private void parseStringSchemaElement(char elementId) { 


marshalers.put(elementId, new StringArgumentMarshaler()); 


public String getString(char arg) 1 


Args.ArgumentMarshaler am = marshalers.get(arg); 


try { 

return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) 1 
return ""; 


j 
} 
public int getInt(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Integer) am.get(); 
} catch (Exception e) 1 


return 0; 


public class Args 1 


private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


接着 ， 由 于 那些 parse 方 法 没有 太 多 事 可 做 ， 我 对 它们 进行 了 内 联 
修改 : 


private void parseSchemaElement(String element) throws 
ParseException 1 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new 
BooleanArgumentMarshaler()); 
else if (isStringSchemaElement(elementTail)) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
} else { 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 
elementTail), 0); 
i 
行 了 ， 下 面 来 看 看 全 景 吧 。 代 码 请 单 14-12 展 示 了 Args 类 的 现状 。 
代码 清单 14-12 Args.java (首次 重 构 后 ) 


package com.objectmentor.utilities.getopts; 


import java.text.ParseException; 
import java.util.*; 
public class Args 1 
private String schema; 
private String[] args; 


private boolean valid 7 true; 


private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private int currentArgument; 
private char errorArgumentld = ^0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT} 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
this.args = args; 
valid = parse(); 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && args.length == 0) 
return true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
} 


return valid; 


private boolean parseSchema() throws ParseException 1 
for (String element : schema.split(",")) { 
if (element.length() > 0) { 
String trimmedElement - element.trim(); 


parseSchemaElement(trimmedElement); 


} 
return true; 
} 
private void — parseSchemaElement(String element) throws 
ParseException { 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementld); 
if (isBooleanSchemaElement(elementTail)) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (isStringSchemaElement(elementTail)) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (isIntegerSchemaElement(elementTail)) { 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
} else 1 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 
elementTail), 0); 
} 


private void validateSchemaElementId(char elementId) throws 
ParseException 1 
if (!Character.isLetter(elementId)) { 
throw new ParseException( 
"Bad character:" + elementId + "in Args format: " + schema, 

0); 

} 
} 


private boolean isStringSchemaElement(String elementTail) { 
return elementTail.equals("*"); 
} 
private boolean isBooleanSchemaElement(String elementTail) { 
return elementTail.length() == 0; 
} 
private boolean isIntegerSchemaElement(String elementTail) { 
return elementTail.equals("#"); 
} 
private boolean parseArguments() throws ArgsException { 
for (currentArgument=0; currentArgument<args.length; 
currentArgument++) { 
String arg = args[currentArgument]; 
parseArgument(arg); 
} 
return true; 
} 
private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 


parseElements(arg); 
j 
private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode = ErrorCode. UNEXPECTED ARGUMENT; 


valid = false; 


} 


private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m = marshalers.get(argChar); 
try 1 

if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 

else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 

else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 

else 
return false; 


} catch (ArgsException e) { 


valid = false; 
errorArgumentId = argChar; 
throw e; 

} 

retum true; 


} 


private void setIntArg(ArgumentMarshaler m) throws ArgsException { 


currentArgument++; 

String parameter = null; 

try { 
parameter = args[currentArgument]; 
m.set(parameter); 

) catch (ArrayIndexOutOfBoundsException e) { 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 

) catch (ArgsException e) 1 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


} 
private void — setStringArg(ArgumentMarshaler 
ArgsException { 
currentArgument++; 
try { 
m.set(args[currentArgument]); 


) catch (ArrayIndexOutOfBoundsException e) { 


m) 


throws 


errorCode = ErrorCode. MISSING STRING; 


throw new ArgsException(); 


} 
private void setBooleanArg(ArgumentMarshaler m) { 
try { 
m.set("true"); 
} catch (ArgsException e) { 
} 
} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) 1 
case OK: 
throw new Exception(" TILT: Should not get here."); 
case UNEXPECTED ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING. STRING: 


return String.format("Could not find string parameter for -%c.", 


errorArgumentlId); 
case INVALID INTEGER: 
return String.format(" Argument -%c expects an integer but was 
'%s'.", 
errorArgumentId, errorParameter); 
case MISSING_INTEGER: 
return String.format("Could not find integer parameter for - 
%c.", 
errorArgumentld); 
} 
return ""; 
} 
private String unexpectedArgumentMessage() { 
StringBuffer message = new StringBuffer(" Argument(s) -"); 
for (char c : unexpectedArguments) { 
message.append(c); 
} 
message.append(" unexpected."); 
return message.toString(); 
} 
public boolean getBoolean(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 
try { 
b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) 1 
b - false; 


} 
return b; 
} 
public String getString(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) 1 


n", 


return  ; 


} 
public int getInt(char arg) { 
Args.ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Integer) am.get(); 
} catch (Exception e) { 


return 0; 


} 
public boolean has(char arg) { 
return argsFound.contains(arg); 
} 
public boolean isValid() { 
return valid; 
} 


private class ArgsException extends Exception { 


} 


private abstract class ArgumentMarshaler 1 
public abstract void set(String s) throws ArgsException; 
public abstract Object get(); 
} 
private class BooleanArgumentMarshaler extends 
ArgumentMarshaler { 
private boolean boolean Value = false; 
public void set(String s) { 
boolean Value = true; 
} 
public Object get() 1 


return boolean Value; 


} 

private class StringArgumentMarshaler extends ArgumentMarshaler 
private String string Value = ""; 

public void set(String s) { 
string Value = s; 

} 

public Object get() { 


return string Value; 


} 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 


private int intValue = 0; 


public void set(String s) throws ArgsException { 
try 1 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) 1 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 

功夫 费 尽 ， 还 是 有 点 失望 。 程 序 结构 好 了 一 点 ， 但 在 代码 顶端 还 
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要 做 的 事 还 很 多 。 

我 真是 想 删 掉 setArgument 里 面 那些 类 型 转换 操作 [G23]。 我 想 要 
setArgument 只 简单 地 调用 ArgumentMarshalerset。 这 意味 着 我 需要 将 
setIntArg 、setStringArg 和 setBooleanArg 推 到 合适 的 ArgumentMarshaler 
派生 类 里 面 。 不 过 这 有 个 问题 。 

仔细 看 setIntArg， 你 会 发 现 ， 它 使 用 了 两 个 实体 变量 : args 和 
currentArg。 为 了 把 setIntArg 移 到 CATA 我 
得 把 这 两 个 变量 都 作为 贸 数 参 数 传 递 过 去 。 那 种 做 法 太 烂 了 [F1]。 我 只 
想 传递 一 个 参数 。 笠 运 的 是 ， 有 个 简单 的 解决 方法 。 可 以 把 args 数 组 转 
换 为 一 个 list， 并 辐 set 函 数 传递 一 个 Iterator。 这 人 花 了 我 10 步 功夫 ， 每 次 
都 通过 了 测试 。 不 过 我 只 回 你 展示 结 末 。 你 应 该 能 看 出 每 个 小 修改 步 
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public class Args 1 
private String schema; 
private boolean valid - true; 
private Set<Character> unexpectedArguments = new 
TreeSet<Character>(); 
private Map<Character, ArgumentMarshaler> marshalers = 
new HashMap<Character, ArgumentMarshaler>(); 
private Set<Character> argsFound = new HashSet<Character>(); 
private Iterator<String> currentArgument; 
private char errorArgumentld = ^0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
private List<String> argsList; 
private enum ErrorCode { 
OK, MISSING_STRING, MISSING_INTEGER, 
INVALID_INTEGER, UNEXPECTED_ARGUMENT} 
public Args(String schema, String[] args) throws ParseException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 
} 
private boolean parse() throws ParseException { 
if (schema.length() == 0 && argsList.size() == 0) 
return true; 


parseSchema(); 


try 1 
parseArguments(); 
) catch (ArgsException e) 1 
} 
return valid; 


} 


private boolean parseArguments() throws ArgsException 1 
for (currentArgument 
argsList.iterator();currentArgument.hasNext();) 1 
String arg = currentArgument.next(); 


parseArgument(arg); 


retun true; 


} 


private void setIntArg(ArgumentMarshaler m) throws ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
m.set(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) { 
errorParameter = parameter; 


errorCode = ErrorCode.INVALID INTEGER; 


throw e; 


private void X setStringArg(ArgumentMarshaler | m) throws 
ArgsException 1 
try 1 
m.set(currentArgument.next()); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode. MISSING. STRING; 


throw new ArgsException(); 


一 一 


Es 要 单 的 修改 让 测 DE 。 现 在 我 们 可 以 开始 把 set 函数 
移植 4 适 的 派生 类 中 了 。 第 一 步 ， 我 要 在 setArgument 中 做 以 下 修 
改 : 
private boolean setArgument(char argChar) throws ArgsException { 


ArgumentMarshaler m = marshalers.get(argChar); 


if (m == null) 
return false; 
try 1 


if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m); 

else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 

else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 


— —eilse 
— return false; 


} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
return true; 
} 
这 个 修改 很 重要 ， 因 为 我 们 想 要 彻 的 删除 那 条 if-else 链 。 所 以 ， 需 
要 把 错误 条 件 抽 离 。 
现在 可 以 开始 移动 set HAL ° setBooleanArg KRM, MATT 
始 。 目 标 是 让 setBooleanArg 琴 数 只 与 BooleanArgumentMarshaler 有 大。 


private boolean setArgument(char argChar) throws ArgsException { 


ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
return false; 
try 1 
if (m instanceof BooleanArgumentMarshaler) 
setBooleanArg(m, currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
} catch (ArgsException e) { 


valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
retum true; 
} 
private void setBooleanArg(ArgumentMarshaler m, 
Iterator<String> currentArgument) 


throws ArgsException { 


try—t 


m.set("true"); 
+ 


} 

我 们 不 是 刚 把 那个 异常 处 理 放 进去 吗 ? 放 进 拿 出 是 重 构 过 程 中 常 
见 的 事 。 小 步 幅 和 保持 测试 通过 ， 意 味 着 你 会 不 断 移动 各 种 东西 。 重 
构 有 点 像 是 解 魔方 。 需 要 经 过 许多 小 步 又 ， 才 能 达到 较 大 目标 。 每 一 
步 都 是 下 一 步 的 基础 。 

为 什么 要 在 setBooleanArg 根本 不 需要 的 情况 下 向 其 传递 iterator 
We ? 为 setIntArg 和 setStringArg 需要 ! 还 因为 我 打算 通过 
ArgumentMarshaler 中 的 抽象 方法 部 署 这 三 个 男 数 ， 需 要 将 其 传递 给 
setBooleanArg ° 


I. ZE setBooleanArg ix Hi f © U5 ArgumentMarshaler F /H ^f set EX 
WM, KIMTUEBIGAT 9 NRI EMAKAT! 第 一 步 ， 在 
ArgumentMarshaler 中 添加 抽象 方法 。 


private abstract class ArgumentMarshaler { 


public abstract void set(Iterator<String> currentArgument) 
throws ArgsException; 
public abstract void set(String s) throws ArgsException; 


public abstract Object get(); 


一 一 


当然 ， 这 会 影响 到 所 有 派生 类 。 所 以 ， 要 逐个 实现 新 方法 。 


private class BooleanArgumentMarshaler extends ArgumentMarshaler 


private boolean booleanValue = false; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 


booleanValue - true; 


public void set(String s) 1 


—— — booleanValue—-—true;- 


public Object get() ( 


return boolean Value; 


} 


private class StringArgumentMarshaler extends ArgumentMarshaler 


n", 


private String string Value = ""; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 

} 

public void set(String s) { 
string Value = s; 

} 

public Object get() { 


return string Value; 


private class IntegerArgumentMarshaler extends ArgumentMarshaler 


private int intValue = 0; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
j 
public void set(String s) throws ArgsException 1 
try 1 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) { 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 
Hte HY DIE RSetBooleanArg J ! 
private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m == null) 
return false; 
try 1 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
setStringArg(m); 
else if (m instanceof IntegerArgumentMarshaler) 
setIntArg(m); 
} catch (ArgsException e) { 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 
return true; 
? 
测试 全 都 通过 ， 而 且 set 函 数 也 部 署 到 BooleanArgumentMarshaler 里 
面 了 ! 
现在 就 能 对 String 和 JInteger 人 参数 的 处 理 做 同样 的 修改 。 
private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m == null) 


return false; 


try 1 
if (m instanceof BooleanArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof StringArgumentMarshaler) 
m.set(currentArgument); 
else if (m instanceof IntegerArgumentMarshaler) 
m.set(currentArgument); 
) catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 
throw e; 
} 


return true; 


}--- 


private class StringArgumentMarshaler extends ArgumentMarshaler { 
private String string Value = ""; 
public void set(Iterator<String> currentArgument) throws 
ArgsException 1 
try 1 
stringValue = currentArgument.next(); 
) catch (NoSuchElementException e) ( 
errorCode = ErrorCode. MISSING STRING; 


throw new ArgsException(); 


} 
public void set(String s) 1 


} 


public Object get() { 


return stringValue; 


} 
private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0; 
public void  set(Iterator<String> currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
set(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode.MISSING_INTEGER; 
throw new ArgsException(); 
} catch (ArgsException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID_INTEGER; 


throw e; 


} 
public void set(String s) throws ArgsException { 
try { 
intValue = Integer.parseInt(s); 
} catch (NumberFormatException e) 1 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 
最 后 一 击 : 可 以 移 除 类 型 转换 了 ! 看 招 ! 
private boolean setArgument(char argChar) throws ArgsException 1 
ArgumentMarshaler m - marshalers.get(argChar); 
if (m == null) 
return false; 
try 1 
m.set(currentArgument); 
return true; 
} catch (ArgsException e) 1 
valid = false; 
errorArgumentId = argChar; 


throw e; 


} 
现在 可 以 删 掉 IntegerArgumentMarshaler 中 那些 过 时 的 函数 ， 做 一 
下 清理 了 。 
private class IntegerArgumentMarshaler extends ArgumentMarshaler { 
private int intValue = 0 
public void — set(Iterator<String> ^ currentArgument) throws 
ArgsException { 
String 


parameter = null; 


try 1 

parameter — currentArgument.next(); 

intValue = Integer.parseInt(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ErrorCode. MISSING INTEGER; 
throw new ArgsException(); 

} catch (NumberFormatException e) { 
errorParameter = parameter; 
errorCode = ErrorCode.INVALID INTEGER; 


throw new ArgsException(); 


public Object get() ( 


return intValue; 


} 
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private interface ArgumentMarshaler { 

void set(Iterator<String> currentArgument) throws ArgsException; 

Object get(); 

} 

现在 来 看 看 往 这 个 结构 中 添加 新 的 参数 类 型 有 多 容易 。 只 需要 做 
少量 修改 ， 而 且 修 改 是 被 隔离 的 。 首 先 ， 增 加 一 个 新 的 测试 用 例 ， 检 
测 double 参 数 是 否 正常 工作 。 

public void testSimpleDoublePresent() throws Exception { 


Args args = new Args("x##", new String[] {"-x","42.3"}); 
assertTrue(args.isValid()); 


assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 


assertEquals(42.3, args.getDouble(' x^), .001); 


} 
然后 清理 范式 解析 代码 ， 为 double 参 数 类 型 添加 席 监 测 。 
private — void X parseSchemaElement(String element) throws 
ParseException 1 
char elementId = element.charAt(0); 
String elementTail = element.substring(1); 
validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else 
throw new ParseException(String.format( 
"Argument: %c has invalid format: %s.", elementld, 


elementTail), 0); 


} 
下 一 步 ， 编 写 DoubleArgumentMarshaler 类 。 
private class DoubleArgumentMarshaler implements 


ArgumentMarshaler { 


private double doubleValue = 0; 


public void  set(Iterator«String^ currentArgument) throws 
ArgsException { 
String parameter = null; 
try 1 
parameter - currentArgument.next(); 
doubleValue - Double.parseDouble(parameter); 
) catch (NoSuchElementException e) ( 
errorCode - ErrorCode. MISSING DOUBLE; 
throw new ArgsException(); 
} catch (NumberFormatException e) { 
errorParameter - parameter; 
errorCode - ErrorCode.INVALID DOUBLE; 
throw new ArgsException(); 
j 
j 
public Object get() { 


return doubleValue; 


j 
然后 就 得 添加 一 个 新 的 ErrorCode: 
private enum ErrorCode { 
OK, MISSING. STRING, MISSING. INTEGER, 
INVALID INTEGER, UNEXPECTED ARGUMENT, 
MISSING. DOUBLE, INVALID DOUBLEJj 
还 需要 一 个 getDouble 函 数 : 
public double getDouble(char arg) { 


Args.ArgumentMarshaler am = marshalers.get(arg); 


try 1 

return am == null ? 0 : (Double) am.get(); 
} catch (Exception e) { 

return 0.0; 


} 


j 
全 部 测试 都 通过 了 ! 完全 无 痛 。 再 来 确保 全 部 错误 处 理 代码 正确 
工作 。 下 一 个 测试 用 例 用 来 检测 在 同 撩 参数 传递 一 个 不 可 解析 的 字符 
串 时 是 否 会 返回 错误 。 
public void testInvalidDouble() throws Exception { 
Args args = new Args("x##", new String[] {"-x","Forty two" }); 
assertFalse(args.is Valid()); 
assertEquals(0, args.cardinality()); 
assertFalse(args.has('x')); 
assertEquals(0, args.getInt('x')); 
assertEquals("Argument -x expects a double but was 'Forty two'.", 


args.errorMessage()); 


public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return unexpectedArgumentMessage(); 
case MISSING_STRING: 


} 


return String.format("Could not find string parameter for - 
Toe: 
errorArgumentlId); 
case INVALID INTEGER: 
return String.format(" Argument -96c expects an integer but 
was '96s'.", 
errorArgumentld, errorParameter); 
case MISSING INTEGER: 
return String.format(" Could not find integer parameter for - 
0G. 5 
errorArgumentld); 
case INVALID DOUBLE: 
return String.format(" Argument -%c expects a double 
but was '%s'.", 
errorArgumentld, errorParameter); 
case MISSING DOUBLE: 
return String.format(" Could not find double parameter 
for -%c.", 
errorArgumentId); 
} 


return  ; 


测试 通过 。 下 一 个 测试 确保 我 们 正确 检测 到 遗漏 的 double 参 数 。 
public void testMissingDouble() throws Exception { 


Args args = new Args("x##", new String[]{"-x"}); 


assertFalse(args.is Valid()); 


assertEquals(0, args.cardinality()); 


assertFalse(args.has('x')); 
assertEquals(0.0, args.getDouble('x'), 0.01); 
assertEquals(" Could not find double parameter for -x.", 
args.errorMessage()); 
} 
测试 如 期 通过 。 我 们 只 是 为 了 你 持 一 切 完 整 而 编写 这 个 测试 。 
异常 代码 很 丑陋 ， 不 该 在 Args 类 中 存在 。 我 们 也 抛 出 
ParseException， 但 那 并 不 真 的 属于 我 们 目 己 。 那 整 把 所 有 异常 都 塞 到 
ArgsException 类 中 ， 并 将 其 移 到 它 上 自己 的 模块 里 面 。 
public class ArgsException extends Exception { 
private char errorArgumentId = ^0'; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode - ErrorCode.OK; 
public ArgsException() {} 
public ArgsException(String message) {super(message);} 
public enum ErrorCode { 
OK, MISSING. STRING, MISSING INTEGER, 
INVALID INTEGER, UNEXPECTED ARGUMENT, 
MISSING DOUBLE, INVALID DOUBLE] 
j 


public class Args 1 


private char errorArgumentld = ^0'; 
private String errorParameter = "TILT"; 
private ArgsException.ErrorCode errorCode = 


ArgsException.ErrorCode.OK; 


private List<String> argsList; 
public Args(String schema, String[] args) throws ArgsException { 
this.schema = schema; 
argsList = Arrays.asList(args); 
valid = parse(); 
} 
private boolean parse() throws ArgsException { 
if (schema.length() == 0 && argsList.size() == 0) 
return true; 
parseSchema(); 
try { 
parseArguments(); 
} catch (ArgsException e) { 
} 
return valid; 
i 


private boolean parseSchema() throws ArgsException { 


} 
private void — parseSchemaElement(String element) throws 


ArgsException { 


else 
throw new ArgsException( 
String.format(" Argument: %c has invalid format: %s.", 


elementId,elementTail)); 


private void validateSchemaElementId(char elementId) throws 
ArgsException 1 
if (!Character.isLetter(elementId)) { 
throw new ArgsException( 


"Bad character:" + elementId + "in Args format: " + schema); 


private void parseElement(char argChar) throws ArgsException 1 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
unexpectedArguments.add(argChar); 
errorCode = 
ArgsException.ErrorCode.UNEXPECTED ARGUMENT; 


valid = false; 


private class StringArgumentMarshaler implements 
ArgumentMarshaler { 
private String string Value = ""; 
public void set(Iterator<String> currentArgument) throws 
ArgsException { 
try { 
stringValue = currentArgument.next(); 


} catch (NoSuchElementException e) { 


errorCode = ArgsException.ErrorCode. MISSING. STRING; 


throw new ArgsException(); 


} 
public Object get() { 


return string Value; 


} 
private class IntegerArgumentMarshaler 
ArgumentMarshaler { 


private int intValue = 0; 


implements 


public void  set(Iterator<String> currentArgument) throws 


ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
intValue = Integer.parseInt(parameter); 


} catch (NoSuchElementException e) { 


errorCode = ArgsException.ErrorCode. MISSING. INTEGER; 


throw new ArgsException(); 
} catch (NumberFormatException e) 1 


errorParameter — parameter; 


errorCode = ArgsException.ErrorCode.IN VALID INTEGER; 


throw new ArgsException(); 


} 
public Object get() { 


return intValue; 


} 
private class DoubleArgumentMarshaler implements 
ArgumentMarshaler { 
private double doubleValue = 0; 
public void  set(Iterator<String> ^ currentArgument) throws 
ArgsException { 
String parameter = null; 
try { 
parameter = currentArgument.next(); 
double Value = Double.parseDouble(parameter); 
} catch (NoSuchElementException e) { 
errorCode = ArgsException.ErrorCode. MISSING DOUBLE; 
throw new ArgsException(); 
} catch (NumberFormatException e) 1 
errorParameter = parameter; 
errorCode = ArgsException.ErrorCode.INVALID_DOUBLE; 


throw new ArgsException(); 


} 
public Object get() { 


return doubleValue; 


很 好 。 现 在 ，Args 抛 出 的 唯一 一 个 异常 是 ArgsException。 把 
ArgsException 移 到 它 自己 的 模块 中 ， 意 味 着 我 们 能 把 大 量 灯 七 杂 八 的 
错误 文 持 代码 从 Args 模 块 转移 到 这 个 模块 。 

现在 我 们 完全 把 异常 和 错误 代码 从 Args 模 块 中 隔离 出 来 了 了 人。 (如 
代码 清单 14-13 人 16 所 示 。) 为 达到 这 一 目标 ， 大 概 做 了 30 次 小 修改 ， 
每 次 修改 都 保持 测试 通过 。 

代码 清单 14-13 ArgsTest.java 

package com.objectmentor.utilities.args; 

import junit.framework.TestCase; 

public class ArgsTest extends TestCase 1 

public void — testCreateWithNoSchemaOrArguments() throws 
Exception 1 


Ww 


Args args = new Args("", new String[0]); 
assertEquals(0, args.cardinality()); 
} 
public void  testWithNoSchemaButWithOneArgument() throws 
Exception 1 
try 1 
new Args( 
fail(); 
) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode. U.NEXPECTED ARG 
UMENT, 


ww 


, new String[]{"-x"}); 


e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


public void testWithNoSchemaButWithMultipleArguments() throws 
Exception 1 
try 1 
new Args("", new String[]{"-x", "-y"}); 
fail(); 
) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode. U.NEXPECTED ARG 
UMENT, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
public void testNonLetterSchema() throws Exception { 
try { 
new Args("*", new String[]{}); 
fail("Args constructor should have thrown exception"); 
) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode.INVALID ARGUMENT _ 
NAME, 
e.getErrorCode()); 
assertEquals('*', e.getErrorArgumentId()); 


} 
public void testInvalidArgumentFormat() throws Exception { 
try { 
new Args("f~", new String[]{}); 


fail("Args constructor should have throws exception"); 


) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode.INVALID FORMAT, 


e.getErrorCode()); 


assertEquals('f', e.getErrorArgumentld()); 
} 
} 
public void testSimpleBooleanPresent() throws Exception { 
Args args = new Args("x", new String[]{"-x"}); 
assertEquals(1, args.cardinality()); 
assertEquals(true, args.getBoolean('x')); 
} 
public void testSimpleStringPresent() throws Exception { 


mom 


Args args = new Args("x*", new String[]{"-x", "param"}); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(" param", args.getString( x')); 
} 
public void testMissingStringArgument() throws Exception { 
try { 
new Args("x*", new String[]{"-x"}); 
fail(); 
) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode. MISSING STRING, 
e.getErrorCode()); 


assertEquals('x', e.getErrorArgumentlId()); 


public void testSpacesInFormat() throws Exception 1 
Args args = new Args("x, y", new String[]{"-xy"}); 
assertEquals(2, args.cardinality()); 
assert True(args.has('x')); 
assert True(args.has(‘y')); 

} 

public void testSimpleIntPresent() throws Exception { 
Args args = new Args("x#", new String[]{"-x", "42"}); 

assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(42, args.getInt('x')); 
} 
public void testInvalidInteger() throws Exception { 
try { 
new Args("x#", new String[]{"-x", "Forty two"}); 
fail(); 
} catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode.INVALID INTEGER, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


assertEquals(" Forty two", e.getErrorParameter()); 


} 
public void testMissingInteger() throws Exception { 
try { 
new Args("x#", new String[]{"-x"}); 
fail(); 


) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode. MISSING INTEGER, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
public void testSimpleDoublePresent() throws Exception { 
Args args = new Args("x##", new String[]{"-x", "42.3" ]); 
assertEquals(1, args.cardinality()); 
assert True(args.has('x')); 
assertEquals(42.3, args.getDouble('x'), .001); 
} 
public void testInvalidDouble() throws Exception { 
try { 
new Args("x##", new String[]{"-x", "Forty two"}); 
fail(); 
} catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode.INVALID DOUBLE, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


assertEquals(" Forty two", e.getErrorParameter()); 


} 
public void testMissingDouble() throws Exception { 
try { 
new Args("x##", new String[]{"-x"}); 
fail(); 


) catch (ArgsException e) 1 
assertEquals(ArgsException.ErrorCode. MISSING DOUBLE, 
e.getErrorCode()); 
assertEquals('x', e.getErrorArgumentlId()); 


} 
代码 清单 14-14 ArgsExceptionTest.java 
public class ArgsExceptionTest extends TestCase { 
public void testUnexpectedMessage() throws Exception 1 
ArgsException e — 
new 
ArgsException(ArgsException.ErrorCode. UNEXPECTED ARGUM 
ENT, 
'x', null); 
assertEquals(" Argument -x unexpected.", e.errorMessage()); 
} 
public void testMissingStringMessage() throws Exception { 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode.MISSING_STRING, 
'x', null); 
assertEquals("Could not find string parameter for -x.", 
e.errorMessage()); 
} 
public void testInvalidIntegerMessage() throws Exception { 


ArgsException e = 


new 
ArgsException(ArgsException.ErrorCode.IN VALID INTEGER, 
'x', "Forty two"); 


assertEquals(" Argument -x expects an integer but was 'Forty 


e.errorMessage()); 


public void testMissingIntegerMessage() throws Exception 1 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode. MISSING. INTEGER, 
'X', null); 
assertEquals("Could not find integer parameter for -x.", 
e.errorMessage()); 
} 
public void testInvalidDoubleMessage() throws Exception { 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode.INVALID DOUBLE, 
'x', "Forty two"); 


assertEquals(" Argument -x expects a double but was 'Forty 


e.errorMessage()); 


public void testMissingDoubleMessage() throws Exception { 
ArgsException e = new 
ArgsException(ArgsException.ErrorCode. MISSING DOUBLE, 


'x', null); 


assertEquals("Could not find double parameter for -x.", 
e.errorMessage()); 
} 
} 
代码 清单 14-15 ArgsException.java 
public class ArgsException extends Exception 1 
private char errorArgumentld = ^0"; 
private String errorParameter = "TILT"; 
private ErrorCode errorCode = ErrorCode.OK; 
public ArgsException() {} 
public ArgsException(String message) {super(message); } 
public ArgsException(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public ArgsException(ErrorCode errorCode, String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
} 
public ArgsException(ErrorCode errorCode, char errorArgumentl d, 
String errorParameter) { 
this.errorCode = errorCode; 
this.errorParameter = errorParameter; 
this.errorArgumentId = errorArgumentlId; 
} 
public char getErrorArgumentld() 1 


return errorArgumentld; 


public void setErrorArgumentId(char errorArgumentId) { 
this.errorArgumentId = errorArgumentlId; 
} 
public String getErrorParameter() { 
return errorParameter; 
} 
public void setErrorParameter(String errorParameter) { 
this.errorParameter = errorParameter; 
} 
public ErrorCode getErrorCode() { 
return errorCode; 
} 
public void setErrorCode(ErrorCode errorCode) { 
this.errorCode = errorCode; 
} 
public String errorMessage() throws Exception { 
switch (errorCode) { 
case OK: 
throw new Exception("TILT: Should not get here."); 
case UNEXPECTED_ARGUMENT: 
return String.format("Argument -%c unexpected.", 
errorArgumentld); 
case MISSING_STRING: 
return String.format("Could not find string parameter for - 
%c.", 
errorArgumentlId); 
case INVALID INTEGER: 


return String.format(" Argument -%c expects an integer but 
was '%s'.", 
errorArgumentld, errorParameter); 
case MISSING INTEGER: 
return String.format("Could not find integer parameter for - 
%c.", 
errorArgumentlId); 
case INVALID DOUBLE: 
return String.format(" Argument -%c expects a double but was 
'9os'.", 
errorArgumentld, errorParameter); 
case MISSING DOUBLE: 
return String.format(" Could not find double parameter for - 
%c.", 
errorArgumentld); 
} 
return ""; 
} 
public enum ErrorCode { 
OK, INVALID FORMAT,  UNEXPECTED ARGUMENT, 
INVALID ARGUMENT NAME, 
MISSING. STRING, 
MISSING. INTEGER, INVALID INTEGER, 
MISSING DOUBLE, INVALID DOUBLE] 
} 


代码 清单 14-16 Args.java 
public class Args 1 


private String schema; 


private Map<Character, ArgumentMarshaler> marshalers = 


new HashMap<Character, ArgumentMarshaler>(); 


private Set<Character> argsFound = new HashSet<Character>(); 


private Iterator<String> currentArgument; 


private List<String> argsList; 


public Args(String schema, String[] args) throws ArgsException { 


this.schema = schema; 
argsList = Arrays.asList(args); 
parse(); 

} 

private void parse() throws ArgsException { 
parseSchema(); 
parseArguments(); 

} 

private boolean parseSchema() throws ArgsException { 
for (String element : schema.split(",")) { 

if (element.length() > 0) { 


parseSchemaElement(element.trim()); 


} 
return true; 
} 
private void parseSchemaElement(String element) 
ArgsException { 
char elementId = element.charAt(0); 


String elementTail = element.substring(1); 


throws 


validateSchemaElementId(elementId); 
if (elementTail.length() == 0) 
marshalers.put(elementId, new BooleanArgumentMarshaler()); 
else if (elementTail.equals("*")) 
marshalers.put(elementId, new StringArgumentMarshaler()); 
else if (elementTail.equals("#")) 
marshalers.put(elementId, new IntegerArgumentMarshaler()); 
else if (elementTail.equals("##")) 
marshalers.put(elementId, new DoubleArgumentMarshaler()); 
else 
throw new 
ArgsException(ArgsException.ErrorCode.IN VALID FORMAT, 
elementId, elementTail); 
} 
private void  validateSchemaElementId(char  elementId) throws 
ArgsException { 
if (!Character.isLetter(elementId)) { 
throw new 
ArgsException(ArgsException.ErrorCode.INVALID ARGUMENT N 
AME, 


elementld, null); 


} 
private void parseArguments() throws ArgsException { 
for (currentArgument = argsList.iterator(); 
currentArgument.hasNext();) { 


String arg = currentArgument.next(); 


parseArgument(arg); 


} 
private void parseArgument(String arg) throws ArgsException { 
if (arg.startsWith("-")) 
parseElements(arg); 
} 
private void parseElements(String arg) throws ArgsException { 
for (int i = 1; i < arg.length(); i++) 
parseElement(arg.charAt(i)); 
} 
private void parseElement(char argChar) throws ArgsException { 
if (setArgument(argChar)) 
argsFound.add(argChar); 
else { 
throw new 
ArgsException(ArgsException.ErrorCode.UNEXPECTED_ARGUME 
NT, 
argChar, null); 


} 
private boolean setArgument(char argChar) throws ArgsException { 
ArgumentMarshaler m = marshalers.get(argChar); 
if (m == null) 
return false; 
try { 


m.set(currentArgument); 


return true; 
} catch (ArgsException e) 1 
e.setErrorArgumentId(argChar); 


throw e; 


} 
public int cardinality() { 
return argsFound.size(); 
} 
public String usage() { 
if (schema.length() > 0) 
return "-[" + schema + "]"; 
else 
return ""; 
i 
public boolean getBoolean(char arg) { 
ArgumentMarshaler am = marshalers.get(arg); 
boolean b = false; 
try { 
b = am != null && (Boolean) am.get(); 
} catch (ClassCastException e) { 
b = false; 
} 
return b; 
} 
public String getString(char arg) { 


ArgumentMarshaler am = marshalers.get(arg); 


try 1 
return am == null ? "" : (String) am.get(); 
} catch (ClassCastException e) { 


n", 


return  ; 


} 
public int getInt(char arg) { 
ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Integer) am.get(); 
} catch (Exception e) 1 


return 0; 


} 
public double getDouble(char arg) { 
ArgumentMarshaler am = marshalers.get(arg); 
try { 
return am == null ? 0 : (Double) am.get(); 
} catch (Exception e) { 
return 0.0; 
} 
} 
public boolean has(char arg) { 


return argsFound.contains(arg); 


对 Args 类 所 做 的 最 主要 的 修改 是 在 监测 部 分 。 从 Args 里 面 取出 了 
大 量 代 码 ， 放 到 ArgsException ¥ » (Reo RIMASTE 
ArgumentMarshaler 转 移 到 了 它们 目 己 的 文件 中 。 更 好 ! 优秀 的 软件 设 
计 ， 大 都 关乎 分 隔 一 -创建 合适 的 空间 放置 不 同 种 类 的 代码 。 对 关注 
面 的 分 隔 让 代码 更 易于 理解 和 维护 。 

特别 有 意思 的 是 ArgsException 中 的 errorMessage 方 法 。 显 然 ， 把 错 
误 信 息 格 式 化 操作 放 在 Args 里 面 ， 违 反 了 SRP 原 则 。Args 应 该 只 处 理 参 
数 ， 不 该 去 管 错 误 信 息 的 格式 。 然 而 ， 把 错误 信息 格式 化 代码 放 到 
ArgsException 中 是 否 有 道理 呢 ? 

实话 说 ， 这 是 种 折衷 做 法 。 不 打算 用 ArgsException 提 供 的 错误 信 
恩 的 用 户 会 想 目 己 写 错误 信息 。 但 如 采 有 备 好 的 错误 信息 ， 其 方便 之 
处 也 并 非 鲜 见 。 

现在 ， 显 然 我 们 已 经 非常 接近 本 章 开 始 处 所 展示 的 最 终 解 决 方案 
了 。 最 后 的 工作 留 给 你 来 练习 完成 。 


14.4 小 结 


代码 能 工作 还 不 够 。 能 工作 的 代码 经 常会 关 重 朋 并 。 满 足 于 仪 仅 
让 代码 能 工作 的 程序 员 不 够 专业 。 他 们 会 害怕 没 时 间 改 进 代码 的 结构 
和 设计 ， 我 不 敢 苟 同 。 没 什么 能 比 糟 料 的 代码 给 开发 项 目 市 来 更 深远 
和 长 期 的 损害 了 。 进 度 可 以 重 订 ， 和 需求 可 以 重新 定义 ， 团 队 动 态 可 以 
修正 。 但 糟糕 的 代码 只 是 一 直 腐 败 发 醇 ， 无 情 地 拖 着 团队 的 后 腿 。 我 
无 数 次 看 到 开发 团队 蹦 中 前 行 ， 只 因为 他 们 缴 勿 摘出 一 片 代 码 沼 泽 ， 
从 此 之 后 命运 再 也 不 受 目 己 欣 制 。 

当然 ， 糟 糕 的 代码 可 以 清理 。 不 过 成 本 高 昂 。 随 着 代码 腐败 下 
去 ， 模 块 之 间 互 相 渗透 ， 出 现 大 量 隐藏 纠结 的 依赖 关系 。 找 到 和 破除 
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所 以 ， 解 决 之 道 束 是 保持 代码 持续 整 涪 和 人 简单。 水 不 让 腐 坏 有 机 


CORE 


[1]. 原 注 ， 最 近 我 用 Ruby 语 言 重 写 了 这 个 模块 。 大 概 只 有 Java 版 本 的 1/7 
大 小 ， 而 且 结构 也 稍 好 一 些 。 


[2]. 译 注 : 即 创建 一 个 类 型 为 ArgumentMarshaler 的 对 象 实体 。 


[3]. 原 注 : 为 了 避免 这 种 情况 发 生 ， 我 添加 了 一 个 新 的 单元 测试 ， 调 用 
所 有 FitNesse 测 试 。 
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框架 之 一 。 就 像 别 的 框架 一 样 ， 它 概 : 


Java 


JUnit 是 最 有 名 的 
定义 精 


代码 是 怎样 的 呢 ? 本章 将 研判 来 自 


。 但 它 的 


确 ， 实 现 优雅 
个 代码 例子 


单 ， 
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框架 的 一 


JUnit 


15.1 JUnit 框 架 


JUnit 有 很 多 位 作者 ， 但 它 始 于 Kent Beck 和 Eric Gamma 一 次 去 亚 特 
兰 大 的 飞行 旅程 。Kent 想 学 Java， 而 Eric 则 打算 学 习 Kent 的 Smalltalk 测 
试 框架。“ 对 于 两 个 喘 处 狭窄 空间 的 奇 客 ， 还 有 什么 会 比 拿 出 笔记 本 电 
脑 开 始 编码 来 得 更 自然 呢 ? [1 经 过 3 小 时 高 海拔 工作 ， 他 们 写 出 了 
JUnit 的 基础 代码 。 

我 们 要 查看 的 模块 ， 是 用 来 帮忙 鉴别 字符 串 比较 错误 的 一 段 陪 明 
代码 。 该 模块 被 命名 为 ComparisonCompactor。 对 于 两 个 不 同 的 字符 
"B, DUI ABCDE 和 ABXDE， 它 将 用 形 如 <...B[X]D...> 的 字符 串 来 曝 
露 两 者 的 不 同 之 处 。 

我 可 以 做 进一步 解释 ， 但 测试 用 例会 更 有 说 服 力 。 看 看 代码 清单 
15-1， 你 将 深入 了 解 到 该 模块 满足 的 需求 。 边 看 代码 ， 边 研究 该 测试 的 
结构 。 它 们 能 变 得 更 简洁 或 更 明确 吗 ? 

代码 清单 15-1 ComparisonCompactorTest.java 


package junit.tests.framework; 


import junit.framework.ComparisonCompactor; 
import junit.framework.TestCase; 
public class ComparisonCompactorTest extends TestCase 1 
public void testMessage() 1 
String failure- new ComparisonCompactor(0, "b", 
"c").compact("a"); 
assertTrue("a expected:<[b]> but was:<[c]>".equals(failure)); 
} 
public void testStartSame() { 


String failure- new ComparisonCompactor(1, "ba", 
"bc").compact(null); 
assertEquals("expected:<b[a]> but was:<b[c]>", failure); 
} 
public void testEndSame() { 
String failure= new ComparisonCompactor(1, "ab", 
"cb").compact(null); 
assertEquals("expected:<[a]b> but was:<[c]b>", failure); 
} 
public void testSame() { 
String failure= new ComparisonCompactor(1, "ab", 
"ab").compact(null); 
assertEquals("expected:<ab> but was:<ab>", failure); 
} 
public void testNoContextStartAndEndSame() { 


String  failue- new  ComparisonCompactor(0, "abc", 
"adc").compact(null); 
assertEquals("expected:<...[b]...> but was:<...[d]...>", failure); 
} 
public void testStartAndEndContext() { 
String failure= new ComparisonCompactor(1, "abc", 


"adc").compact(null); 
assertEquals("expected:<a[b]c> but was:<a[d]c>", failure); 
} 
public void testStartAndEndContextWithEllipses() { 
String failure= 


new ComparisonCompactor(1, "abcde", "abfde").compact(null); 


assertEquals("expected:<...b[c]d...> but was:<...b[f]d...>", failure); 
} 
public void testComparisonErrorStartSameComplete() { 
String failure= new ComparisonCompactor(2, "ab", 
"abc").compact(null); 
assertEquals(" expected: «ab[]» but was:<ab[c]>", failure); 
} 
public void testComparisonErrorEndSameComplete() { 
String failure= new ComparisonCompactor(0, "bc", 
"abc").compact(null); 
assertEquals("expected:<[]...> but was:<[a]...>", failure); 
} 
public void testComparisonErrorEndSameCompleteContext() { 
String failure= new ComparisonCompactor(2, "bc", 
"abc").compact(null); 
assertEquals("expected:<[]bc> but was:<[a]bc>", failure); 
} 


public void testComparisonErrorOverlapingMatches() { 


String failure= new ComparisonCompactor(0, "abc", 
"abbc").compact(null); 
assertEquals("expected:<...[]...> but was:<...[b]...>", failure); 
} 
public void testComparisonErrorOverlapingMatchesContext() { 
String failure= new ComparisonCompactor(2, "abc", 


"abbc").compact(null); 


assertEquals("expected:<ab[]c> but was:<ab[b]c>", failure); 


public void testComparisonErrorOverlapingMatches2() 1 
String failure- new ComparisonCompactor(0, "abcdde", 
"abcde").compact(null); 
assertEquals("expected:<...[d]...> but was:<...[]...>", failure); 
} 
public void testComparisonErrorOverlapingMatches2Context() { 
String failure= 
new ComparisonCompactor(2, "abcdde", "abcde").compact(null); 
assertEquals("expected:<...cd[d]e> but was:<...cd[]e>", failure); 
} 
public void testComparisonErrorWithA ctualNull() { 
String failure- new ComparisonCompactor(0, "a", 
null).compact(null); 
assertEquals("expected:<a> but was:<null>", failure); 
} 
public void testComparisonErrorWithActualNullContext() { 
String failure= new ComparisonCompactor(2, "a", 
null).compact(null); 
assertEquals("expected:<a> but was:<null>", failure); 
} 
public void testComparisonErrorWithExpectedNull() { 
String failure= new ComparisonCompactor(0, null, 
"a").compact(null); 
assertEquals("expected:<null> but was:<a>", failure); 
} 
public void testComparisonErrorWithExpectedNullContext() { 


String failure- new ComparisonCompactor(2, null, 
"a").compact(null); 
assertEquals(" expected: «null» but was:<a>", failure); 
} 
public void testBug609972() { 
String failure= new  ComparisonCompactor(10, "S&P500", 
"0").compact(null); 
assertEquals("expected:<[S&P50]0> but was:<[]0>", failure); 


} 
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ComparisonCompactor 的 代码 如 代码 清单 15-2 所 示 。 

代码 清单 15-2 ComparisonCompactor.java (原始 版 本 ) 


package junit.framework; 


public class ComparisonCompactor 1 
private static final String ELLIPSIS = "..."; 
private static final String DELTA, END = "]"; 
private static final String DELTA. START = "["; 
private int f ContextLength; 
private String fExpected; 
private String fActual; 
private int fPrefix; 
private int fSuffix; 


public ComparisonCompactor(int contextLength, 


String expected, 
String actual) 1 
fContextLength = contextLength; 
fExpected - expected; 
fActual - actual; 
} 
public String compact(String message) { 
if (Expected == null || fActual == null || areStringsEqual()) 
return Assert.format(message, fExpected, fActual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(fExpected); 
String actual = compactString(fActual); 
return Assert.format(message, expected, actual); 
} 
private String compactString(String source) { 
String result = DELTA_START + 
source.substring(fPrefix, source.length() - 
fSuffix + 1) + DELTA_END; 
if (fPrefix > 0) 
result = computeCommonPrefix() + result; 
if (fSuffix > 0) 
result = result + computeCommonSuffix(); 
return result; 
} 
private void findCommonPrefix() { 
fPrefix = 0; 


int end = Math.min(fExpected.length(), fActual.length()); 
for (; fPrefix < end; fPrefix++) { 
if (fExpected.charAt(fPrefix) != fActual.charAt(fPrefix)) 
break; 


} 
private void findCommonSuffix() { 
int expectedSuffix = fExpected.length() - 1; 
int actualSuffix = fActual.length() - 1; 
for (; 
actualSuffix >= fPrefix && expectedSuffix >= fPrefix; 
actualSuffix--, expectedSuffix--) { 
if (fExpected.charAt(expectedSuffix) l= 
fActual.charAt(actualSuffix)) 
break; 
} 
fSuffix = fExpected.length() - expectedSuffix; 
} 
private String computeCommonPrefix() { 
return (fPrefix > fContextLength ? ELLIPSIS : "") + 
fExpected.substring(Math.max(0, fPrefix - fContextLength), 


fPrefix); 
} 
private String computeCommonSuffix() { 
int end =  Math.min(fExpected.length() - fSuffix + 1 + 
fContextLength, 


fExpected.length()); 


return fExpected.substring(fExpected.length() - fSuffix + 1, end) + 
(fExpected.length() - fSuffix + 1 « fExpected.length() - 
fContextLength ? ELLIPSIS : ""); 


private boolean areStringsEqual() 1 


return fExpected.equals(fA ctual); 


} 
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+1 操 作 ， 如 此 等 等 。 不 过 ， 总 的 来 说 ， 这 个 模块 很 不 错 。 毕 竟 它 原本 
可 能 被 写成 如 代码 清单 15-3 中 的 样子 。 

代码 清单 15-3 ComparisonCompator.java (背离 版 本 ) 

package junit.framework; 

public class ComparisonCompactor 1 

private int ctxt; 
private String s1; 
private String s2; 
private int pfx; 
private int sfx; 
public ComparisonCompactor(int ctxt, String s1, String s2) 1 
this.ctxt = ctxt; 
this.s1 = s1; 
this.s2 = s2; 
} 
public String compact(String msg) { 
if (s1 == null || s2 == null || s1.equals(s2)) 


return Assert.format(msg, s1, s2); 


pfx = 0; 
for (; pfx < Math.min(s1.length(), s2.length()); pfx++) { 
if (s1.charAt(pfx) != s2.charAt(pfx)) 
break; 
} 
int sfx1 = s1.length() - 1; 
int sfx2 = s2.length() - 1; 
for (; sfx2 >= pfx && sfx1 >= pfx; sfx2--, sfx1--) { 
if (s1.charAt(sfx1) != s2.charAt(sfx2)) 
break; 
} 
sfx = s1.length() - sfx1; 
String cmp1 = compactString(s1); 
String cmp2 = compactString(s2); 
return Assert.format(msg, cmp1, cmp2); 
i 
private String compactString(String s) { 
String result = 
"[" + s.substring(pfx, s.length() - sfx + 1) + "J"; 
if (pfx > 0) 
result = (pfx > ctxt ? "..." : "") + 
s1.substring( Math.max(0, pfx - ctxt), pfx) + result; 
if (sfx > 0) { 
int end = Math.min(s1.length() - sfx + 1 + ctxt, s1.length()); 
result = result + (s1.substring(s1.length() - sfx + 1, end) + 
(s1.length() - sfx + 1 < s1.length() - ctxt ? "..." : "")); 


return result; 


j 
即便 作者 们 把 这 个 模块 写 得 已 经 很 棒 ， 但 童子 军 军 规 [2] 却 告诉 我 
们 ， 离 时 要 比 来 时 整洁 。 所 以 ， 我 们 怎样 才能 改进 代码 清单 15-2 中 的 原 
始 代码 呢 ? 
我 自 完 看 到 的 是 成 员 变 量 的 f 前 缀 [IN6]。 在 现今 的 运行 环境 中 ， 这 
类 记 围 性 编码 纯 属 多 余 。 所 以 ， 先 删除 所 有 的 f 前 级 。 
private int contextLength; 
private String expected; 
private String actual; 
private int prefix; 
private int suffix; 
下 一 步 ， 在 compact 芳 数 开 始 处 ， 有 一 个 未 封 狠 的 条 件 判断 [G28] 。 
public String compact(String message) { 
if (expected == null || actual == null || areStringsEqual()) 
return Assert.format(message, expected, actual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 
j 
这 个 条 件 判 断 应 当 封 装 起 来 ， 从 而 更 清晰 地 表达 代码 的 意图 。 我 
们 拆 解 出 一 个 方法 ， 解 释 这 个 条 件 判断 。 
public String compact(String message) { 
if (shouldNotCompact()) 


return Assert.format(message, expected, actual); 
findCommonPrefix(); 
findCommonSuffix(); 
String expected = compactString(this.expected); 
String actual = compactString(this.actual); 
return Assert.format(message, expected, actual); 
} 
private boolean shouldNotCompact() { 
return expected == null || actual == null || areStringsEqual(); 
j 
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员 变 量 同名 呢 ? 它们 不 是 该 表示 其 他 意思 吗 [IN4]? 我 们 应 该 区 分 这 些 
名 称 。 


String compactExpected = compactString(expected); 


String compactActual = compactString(actual); 
否定 式 稍微 比 肯 定式 难 理解 一 些 [G29]。 我 们 把 证 语句 放 到 上 头 ， 
调转 条 件 判 晰 。 
public String compact(String message) { 
if (canBeCompacted()) { 
findCommonPrefix(); 
findCommonSuffix(); 
String compactExpected = compactString(expected); 
String compactActual = compactString(actual); 
return Assert.format(message, compactExpected, compactActual); 
} else 1 


return Assert.format(message, expected, actual); 


} 
private boolean canBeCompacted() { 
return expected != null && actual != null && !areStringsEqual(); 

} 

KA TREE [NT] REENASH AS, (UR 
canBeCompact 为 false， 它 实际 上 束 不 会 压缩 字符 串 。 用 compact 来 命 
名 ， 隐 藏 了 错误 检查 的 副作用 。 注 意 ， 该 函数 返回 一 条 格式 化 后 的 消 
已 ， 而 不 仅仅 只 是 压 绑 后 的 字符 串 。 所 以 ， 函 数 名 其 实 应 该 是 
formatCompacted Comparison。 在 用 以 下 参数 调用 时 ， 读 起 来 会 好 很 


> 


public String formatCompactedComparison(String message) { 

两 个 字符 串 是 在 站 语句 体 中 压缩 的 。 我 们 应 当 拆 分 出 一 个 名 为 
compactExpectedAndActual HJ 7; iE © Am, RE 
formatCompactComparison 函 数 完成 所 有 的 格式 化 工作 。 而 compact.. E 
数 除了 压缩 之 外 什么 都 不 做 [G30]。 所 以 ， 做 如 下 拆 分 


private String compactExpected; 


private String compactActual; 


public String formatCompactedComparison(String message) { 
if (canBeCompacted()) { 
compactExpectedAndActual(); 
return Assert.format(message, compactExpected, 
compactActual); 
} else { 


return Assert.format(message, expected, actual); 


} 

private void compactExpectedAndActual() { 
findCommonPrefix(); 

findCommonSuffix(); 

compactExpected = compactString(expected); 

compactActual = compactString(actual); 

} 

TER, xXx ER RT qp pe D 3B E AS T£ compactExpected 和 
compactActual。 我 不 喜欢 新 函数 最 后 两 行 返 回 变量 的 方式 ， 但 前 两 个 
可 不 是 这 样 。 它 们 没 采 用 一 以 贯 之 的 约定 [G11]。 我 们 应 该 修改 
findCommonPrefix 和 findCommonSuffix， 返 回 前 级 和 后 级 值 。 

private void compactExpectedAndActual() 1 


prefixIndex = findCommonPrefix(); 
suffixIndex = findCommonSuffix(); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 
} 
private int findCommonPrefix() { 
int prefixIndex = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex++) { 
if (expected.charAt(prefixIndex) != actual.charAt(prefixIndex)) 
break; 
return prefixIndex; 


} 


private int findCommonSuffix() { 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; actualSuffix >= prefixIndex && expectedSuffix >= 
prefixIndex; 
actualSuffix--, expectedSuffix--) { 
if (expected.charAt(expectedSuffix) l= 
actual.charAt(actualSuffix)) 
break; 
return expected.length() - expectedSuffix; 
} 
} 
我 们 还 应 该 修改 成 员 变 量 的 名 称 ， 使 之 更 准确 一 点 [N1]; PEE 
们 都 是 索引 。 
仔细 检查 findCommonSuffiz， 其 中 藏 了 个 时 序 性 耦合 [G31];， EK 
+ prefixIndex 是 由 findCommonSuffix 计 算得 来 的 事实 。 如 果 这 两 个 方 
法 不 是 按 这 样 的 顺序 调用 ， 调 试 就 会 变 得 困难 。 为 了 烘 露 这 个 时 序 性 
耦合 ， 我 们 将 prefixIndex 做 成 find 的 参数 。 


private void compactExpectedAndActual() 1 


prefixIndex = findCommonPrefix(); 
suffixIndex = findCommonSuffix(prefixIndex); 
compactExpected = compactString(expected); 
compactActual = compactString(actual); 

} 

private int findCommonSuffix(int prefixIndex) { 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 


for (; actualSuffix >= prefixIndex && expectedSuffix >= 
prefixIndex; 
actualSuffix--, expectedSuffix--) ( 
if (expected.charAt(expectedSuffix) != actual.charAt(actualSuffix)) 
break; 
} 
return expected.length() - expectedSuffix; 

} 

我 对 这 样 的 方式 不 太 满 意 。 传 递 prefixIndex 参数 有 些 随意 [G32]。 
它 成 功 维持 了 执行 次 序 ， 但 对 于 解释 排序 的 需要 却 宣 无 作用 。 其 他 程 
序 员 可 能 会 抹杀 我 们 刚 完成 的 工作 ， 因 为 并 没有 迹象 说 明 该 参数 确 属 
必要 。 还 是 采取 别 的 做 法 吧 。 

private void compactExpectedAndActual() 1 

findCommonPrefixAndSuffix(); 


compactExpected = compactString(expected); 


compactActual = compactString(actual); 
} 
private void findCommonPrefixAndSuffix() { 
findCommonPrefix(); 
int expectedSuffix = expected.length() - 1; 
int actualSuffix = actual.length() - 1; 
for (; 
actualSuffix >=  prefixIndex && expectedSuffix >= 
prefixIndex; 
actualSuffix--, expectedSuffix-- 


)1 


if (expected.charAt(expectedSuffix) l= 
actual.charAt(actualSuffix)) 
break; 
} 
suffixIndex = expected.length() - expectedSuffix; 
} 
private void findCommonPrefix() { 
prefixIndex = 0; 
int end = Math.min(expected.length(), actual.length()); 
for (; prefixIndex < end; prefixIndex++) 
if (expected.charAt(prefixIndex) != actual.charAt(prefixIndex)) 
break; 

} 

我 们 恢复 findCommonPreffix 和 findCommonSuffix 的 原样 ， 把 
findCommonSuffix 的 名 称 改 为 fndCommonPrefixAndSuffix， 让 它 在 执行 
其 他 操作 之 前 ， 先 调用 findCommonPrefix。 这 样 一 来 ， 就 以 一 种 相 比 前 
种 手段 更 为 有 效 的 方式 建立 了 两 个 函数 之 间 的 时 序 关系 。 


private void findCommonPrefixAndSuffix() { 


findCommonPrefix(); 
int suffixLength - 1; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) ( 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength)) 
break; 
} 


suffixIndex = suffixLength; 


private char charFromEnd(String s, int i) 1 
return s.charAt(s.length()-i); 
} 
private boolean suffixOverlapsPrefix(int suffixLength) { 
return actual.length() - suffixLength « prefixLength || 
expected.length() - suffixLength « prefixLength; 
} 
这 样 就 好 多 了 。 它 暴露 出 suffixIndex 其 实 是 后 级 的 长 度 ， 而 且 名 字 
没 取 好 。 对 于 prefix 也 是 如 此 。 虽 然 在 那样 一 种 情形 下 index 和 length 是 
同 义 的 ， 但 使 用 length 一 词 却 更 有 一 贯 性 。 问 题 在 于 ，suffixIndex 变 量 
并 不 从 0 开始 ， 它 从 1 开始 ， 所 以 并 非 真正 的 长 度 。 这 也 是 
computeCommonSuffix 中 那些 +1 存 在 的 原因 [G33]。 来 修正 它们 吧 。 结 
Fe T ROTE 815-4 。 
代码 清单 15-4 ComparisonCompactor.java (过 渡 版 本 ) 


public class ComparisonCompactor { 


private int suffixLength; 


private void findCommonPrefixAndSuffix() { 
findCommonPrefix(); 
suffixLength - 0; 
for (; !suffixOverlapsPrefix(suffixLength); suffixLength++) ( 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength)) 
break; 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
} 
private boolean suffixOverlapsPrefix(int suffixLength) { 
return actual.length() - suffixLength <= prefixLength || 
expected. length() - suffixLength <= prefixLength; 


private String compactString(String source) { 

String result = 
DELTA_START + 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA_END; 

if (prefixLength > 0) 
result = computeCommonPrefix() + result; 

if (suffixLength > 0) 
result = result + computeCommonSuffix(); 


return result; 


private String computeCommonSuffix() { 
int end = Math.min(expected.length() - suffixLength + 
contextLength, expected.length() 
); 
return 
expected.substring(expected.length() - suffixLength, end) + 
(expected.length() - suffixLength « 


expected.length() - contextLength ? 
ELLIPSIS : ""); 
} 

我 们 用 charFromEnd 中 的 那个 -1 蔡 代 了 computeCommonSuffix 中 的 
一 堆 +1， 前 者 更 为 合情合理 ，suffixzOverlapsPrefix 中 的 两 个 “<=” 操 作 符 
也 同 理 。 这 样 我 们 就 能 修改 suffixImmdex 和 suffixLength 的 名 称 ， 极 大 地 
提升 了 代码 的 可 读 性 。 

不 过 还 有 一 个 问题 。 在 消灭 那些 +1 时 ， 我 注意 到 compactString 中 
的 以 下 代码 : 

if (suffixLength > 0) 

看 看 代码 清单 15-4 中 的 这 行 代 码 。 因 为 suffixLength 现 在 要 比 原本 
少 1， 我 应 该 把 “>” 损 作 符 改 为 ">=” 操 作 符 。 那 本 无 道理 ， 不 过 现在 却 
有 意义 ! 这 表示 这 么 做 没 道理 ， 而 且 可 能 是 个 缺陷 。 咽 ， 也 不 算是 个 
缺陷 。 从 之 前 的 分 析 中 我 们 可 以 看 到 ， 证 语句 现在 会 放置 添加 长 度 为 零 
的 后 级 。 在 作出 修改 之 前 ，if 语 句 没 有 作用 ， 因 为 suffixIndex 永 不 会 小 
Jie 

IX {AA compactString FAY Pj ifi 6) Sp ale! 看 起 来 它们 都 该 删 
除 。 所 以 ， 我 们 将 其 注释 掉 ， 运 行 测试 。 测 试 通过 了 ! PRESI 
compactString， 删 除 没 用 的 话语 句 ， 将 图 数 改 得 更 加 人 简 清 [G9] © 


private String compactString(String source) { 


return 
computeCommonPrefix() + 
DELTA_START + 
source.substring(prefixLength, source.length() - suffixLength) + 
DELTA_END + 


computeCommonSuffix(); 


这 样 就 好 多 了 ! MERITE], compactString a H ee Ez 2H 
起 来 。 我 们 甚至 可 以 让 它 更 清晰 。 有 许多 细微 的 整理 工作 可 做 。 与 其 
拖 着 你 遍历 简 下 的 那些 修改 ， 我 更 愿意 直接 展示 代码 清单 15-5 中 的 结 
果 o 

代码 清单 15-5 ComparisonCompactor.java (最 终 版 ) 


package junit.framework; 


public class ComparisonCompactor 1 
private static final String ELLIPSIS = "..."; 
private static final String DELTA, END = "]"; 
private static final String DELTA. START = "["; 
private int contextLength; 
private String expected; 
private String actual; 
private int prefixLength; 
private int suffixLength; 
public ComparisonCompactor( 
int contextLength, String expected, String actual 
){ 
this.contextLength = contextLength; 
this.expected = expected; 
this.actual = actual; 
} 
public String formatCompactedComparison(String message) { 
String compactExpected = expected; 
String compactActual = actual; 
if (shouldBeCompacted()) { 
findCommonPrefixAndSuffix(); 


compactExpected = compact(expected); 
compactActual = compact(actual); 


} 


return Assert.format(message, compactExpected, compactActual); 
} 
private boolean shouldBeCompacted() { 
return !shouldNotBeCompacted(); 
} 
private boolean shouldNotBeCompacted() { 
return expected == null || 
actual == null || 
expected.equals(actual); 
} 
private void findCommonPrefixAndSuffix() { 
findCommonPrefix(); 
suffixLength = 0; 
for (; !suffixOverlapsPrefix(); suffixLength++) { 
if (charFromEnd(expected, suffixLength) != 
charFromEnd(actual, suffixLength) 


break; 


} 


private char charFromEnd(String s, int i) { 
return s.charAt(s.length() - i - 1); 
} 


private boolean suffixOverlapsPrefix() { 


return actual.length() - suffixLength «- prefixLength || 


expected.length() - suffixLength «- prefixLength; 
} 
private void findCommonPrefix() { 


prefixLength = 0; 


int end = Math.min(expected.length(), actual.length()); 


for (; prefixLength « end; prefixLength++) 
if (expected.charAt(prefixLength) l= 
(prefixLength)) 
break; 
} 
private String compact(String s) { 
return new StringBuilder() 
.append(startingEllipsis()) 
.append(startingContext()) 
.append(DELTA_START) 
.append(delta(s)) 
.append(DELTA. END) 
.append(endingContext()) 
.append(endingEllipsis()) 
.toString(); 
} 
private String startingEllipsis() { 


actual.charAt 


return prefixLength > contextLength ? ELLIPSIS : ""; 


} 
private String startingContext() { 


int contextStart = Math.max(0, prefixLength - contextLength); 


int contextEnd = prefixLength; 
return expected.substring(contextStart, contextEnd); 
} 
private String delta(String s) { 
int deltaStart = prefixLength; 
int deltaEnd = s.length() - suffixLength; 
return s.substring(deltaStart, deltaEnd); 
} 
private String endingContext() { 
int contextStart = expected.length() - suffixLength; 
int contextEnd = 
Math.min(contextStart + contextLength, expected.length()); 
return expected.substring(contextStart, contextEnd); 
} 
private String endingEllipsis() 1 
return (suffixLength > contextLength ? ELLIPSIS : ""); 


KITIARA o BRR oD HR T HIMEZA-A SAR È 
们 以 一 种 拓扑 方式 排序 ， 每 个 函数 的 定义 都 正好 在 其 被 调用 的 位 置 后 
面 。 所 有 的 分 析 函 数 都 和 完 出 现 ， 而 所 有 的 合成 男 数 都 最 后 出 现 。 
仔细 阅读 ， 你 会 发 现 我 推翻 了 在 本 章 较 前 E ! 
例如 ， 我 将 几 个 分 解 出 来 的 方法 重新 内 联 为 
format Comper paperisen REAT ai TÉ 
思 。 这 种 做 法 很 常见 。 重 构 常 会 导致 男 一 次 推翻 此 次 重 构 的 重 构 。 重 
构 是 一 种 不 停 试 错 的 迭代 过 程 ， 不 可 避免 地 集中 于 我 们 认为 是 专业 人 
员 该 做 的 事 。 


15.2 小 结 


如 此 我 们 亲 循 了 鞋子 军 军 规 。 模 块 比 我 们 发 现 它 时 更 整洁 了 。 不 
征 说 它 原 本 不 整 污 。 作 者 们 做 了 嘻 越 的 工作 。 但 模块 都 能 再 改进 ， 我 
们 每 个 人 也 有 责任 把 模块 改进 得 比 发 现时 更 整洁 。 


[1]. 原 注 : JUnit Pocket Guide, Kent Beck, O'Reilly, 2004, P.43 ° 
[2]. 原 注 : WEI MAKET > 


16 SerialDate 


d È VK Ui IH] http://www.jfree.org/jcommon/index.php ， 就 能 找到 
JCommon 类 库 。 深 入 该 类 库 ， 其 中 有 个 名 为 org,jfree.date 的 程序 包 。 在 
该 程序 包 中 ， 有 个 名 为 SerialDate 的 类 。 我 们 即将 剖析 这 个 类 。 


SerialDate 的 作者 是 David Gilbert。David 显 然 是 位 经 验 丰 富 、 能 力 
足够 的 程序 员 。 如 我 们 将 看 到 的 ， 他 在 代码 中 展示 了 极 高 的 专业 性 和 
原则 性 。 无 论 怎 么 说 ， 这 都 是 “好 代码 ”。 而 我 将 把 它 撕 成 碎片 。 


这 并 非 恶 意 的 行为 。 我 也 不 认为 自己 比 戴 维 强 许 多 ， 有 权 对 他 的 
代码 说 三 道 四 。 其 实 ， 如 果 你 看 过 我 的 代码 ， 我 敢 说 你 也 会 发 现 好 些 
该 埋怨 的 东西 。 

不 ， 这 也 并 非 傲 慢 无 礼 的 行为 。 我 所 要 做 的 ， 只 是 一 种 专业 眼光 
的 检视 ， 不 多 也 不 少 。 那 是 我 们 都 该 坦然 接受 的 做 法 。 那 是 我 们 应 该 
欢迎 别人 对 目 己 做 的 事 。 只 有 通过 这 样 的 批评 ， 我 们 才能 学 到 东西 。 
医生 就 是 这 样 做 的 。 飞 行 员 就 是 这 样 做 的 。 律 师 束 是 这 样 做 的 。 我 们 
程序 员 也 需要 学 习 如 何 这 样 做 。 

多 说 一 句 关 于 David Gilbert 的 事 : David 不 止 是 位 优秀 的 程序 员 。 
戴 维 有 着 将 代码 免费 呈献 给 社区 的 勇气 和 好 心 。 他 公开 代码 ， 让 所 有 
人 都 能 看 到 ， 邀 请 大 众 使 用 并 审查 。 做 得 真 好 ! 

SerialDate 〈 见 代码 清单 B-1) 是 一 个 用 Java 呈现 一 个 日 期 的 类 。 为 
什么 在 Java 已 经 有 java.util.Date 和 java.util.Calendar 的 时 候 ， 还 需要 一 个 
呈现 日 期 的 类 呢 ? 作 者 编写 这 个 类 ， 是 为 了 响应 我 自己 也 常 感到 的 痛 
苗 。 在 开放 的 Javadoc (第 67 行 ) 中 ， 他 很 好 地 解释 了 原因 。 我 们 可 以 
质疑 他 的 初衷 ， 但 我 的 确 有 处 理 这 个 问题 的 需要 ， 而 且 我 也 欢迎 有 个 
关心 日 期 其 于 时 间 的 类 存在 。 


16.1 LEE BEL 


在 一 个 名 为 SerialDateTests 的 类 〈 见 代码 清单 B-2) 中 ， 有 一 些 单元 
测试 。 测 试 都 通过 了 。 不 驻 的 是 ， 快 多 一 过 测试 ， 发 现 它 们 并 没有 测 
试 所 有 东西 [T1]。 例 如 ， 用 “查找 使 用 ”搜索 方法 MonthCodeToQuarter 

(第 334 行 ) ， 会 发 现 没 有 被 用 过 [F4]。 因 此 ， 单 元 测试 并 没有 测试 这 
qun 


所 以 ， 我 用 Clover 来 检查 单元 测试 覆盖 了 哪些 代码 。Clover 报 告 
说 ， 在 SerialDate 的 185 个 可 执行 语句 中 ， 单 元 测试 只 执行 了 91 个 (2) 
5096) [T2]。 履 盖 图 看 起 来 像 是 一 床 满 是 补丁 的 棉 被 ， 整 个 类 上 布 满 大 
块 的 未 执行 代码 。 

我 的 目标 是 完整 地 理解 和 重 构 这 个 类 。 没 有 好 得 多 的 测试 覆 兰 
率 ， 做 不 到 这 个 。 所 以 ， 我 完全 重 起 炉灶 编写 了 自己 的 单元 测试 〈 见 
代码 清单 B-4) 

在 阅读 这 些 测试 时 ， 你 可 以 看 到 ， 其 中 许多 注释 掉 了 。 这 些 测试 
不 能 通过 。 它 们 代表 了 我 以 为 SerialDate 应 该 有 的 行为 。 在 我 重 构 
SerialDate 时 ， 也 将 让 这 些 测试 通过 。 

即便 有 些 测试 被 注释 掉 ，Clover 还 是 报告 狐 的 单元 测试 执行 了 185 
个 可 执行 语句 中 的 170 个 (92%) 。 这 样 就 好 多 了 ， 而 且 我 想 我 们 可 以 
把 这 个 数字 提高 些 。 

前 几 个 注释 掉 的 测试 (2823-6317) 是 我 一 厢 情 愿 。 程 序 并 没有 
设计 为 通过 这 些 测 试 ， 但 对 我 来 说 它们 代表 的 行为 显而易见 [G2]。 我 
不 太 确 定 testWeekdayCodeToString 方 法 为 何 要 写成 那样 ， 不 过 既然 它 
已 经 在 那儿 ， 显 然 不 该 是 区 分 大 小 写 的 。 编 写 这 些 测 试 是 区 区 小 事 
[T3]， 通 过 测试 更 加 容易 。 我 只 修改 了 第 259 行 和 和 263 行 ， 就 能 使 用 
equalsIgnoreCase Į ° 

我 注释 掉 了 第 32 行 和 第 45 行 的 测试 ， 因 为 我 不 太 明 确 是 否 应 该 文 
持 tues 和 thurs 缩 写 。 

第 153 行 和 154 行 的 测试 不 能 通过 。 显 然 ， 它 们 本 该 通过 [G2]。 我 
们 可 以 轻易 地 修正 ， i 以 下 修改 就 行 ， 对 
于 第 163 行 和 213 行 的 测试 也 一 样 。 

457 if((result < 1) || (result? 12)){ 


result = -1; 


458 for (inti=0; i<monthNames.length; i++) { 


459 if 
(s.equalsIgnoreCase(shortMonthNamesli])) 1 


460 result=i+ 1; 

461 break; 

462 } 

463 if (s.equalslgnoreCase(monthNames[i])) 1 
464 result=i+ 1; 

465 break; 

466 } 

467 } 

468 } 
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缺陷 (5867211) 。2004 年 12 月 25 日 是 个 周 六 。 下 一 个 周 六 是 2005 年 1 
月 1 日 。 然 而 ， 运 行 测 试 时 ， 会 看 到 getFollowingDayOfWeek 返 回 12 月 25 
日 之 后 的 周 六 还 是 12 月 25 日 。 显 然 这 不 对 [G3] [T1。 我 们 看 到 问题 在 
第 685 行 。 那 是 个 典型 的 边界 条 件 错误 [T5]。 应 该 是 这 样 : 

685 if (baseDOW >= targetWeekday) { 

很 有 意思 ， 这 个 函数 是 之 前 一 次 修改 的 结果 。 修 改 记录 (#43 
fi) 显示 ， getPreviousDayOfWeek ^ getFollowingDayOfWeek 和 
getNearestDayOfWeek 中 的 “缺陷 ”已 被 修正 [T6]。 

测 试 getNearestDayOfWeek ( 58 705 f7 ) 的 单元 测试 
testGetNearestDayOfWeek (第 329 行 ) 之 前 的 版 本 不 像 现在 一 样 没 有 遗 
漏 。 我 添加 了 大 量 测试 用 例 ， 因 为 初始 的 测试 用 例 并 没有 全 部 通过 
[T6]。 查 看 哪些 测试 用 例 被 注释 掉 ， 你 可 以 看 到 失败 的 模式 ， 这 很 有 局 
发 。 如 有 条 最 近 的 日 期 是 在 未 来 ， 算 法 融会 失败 。 显 然 存 在 某 种 边 弄 条 
件 错误 [T5]。 


Clover 汇 报 的 测试 覆盖 模式 也 很 有 趣 [T8]。 第 719 行 根本 没有 执 
行 ! 这 意味 着 第 718 行 的 让 语句 总 是 得 到 false 的 结果 。 没 错 ， 看 一 腿 代 
码 瓯 知道 是 这 样 。 变 量 adjust 总 是 为 负 ， 所 以 不 会 大 于 或 等 于 4。 所 
A, RIAH T ° 

正确 的 算法 如 下 所 示 : 

int delta = targetDOW - base.getDayOfWeek(); 

int positiveDelta = delta + 7; 

int adjust = positiveDelta % 7; 

if (adjust > 3) 

adjust -= 7; 

return SerialDate.addDays(adjust, base); 

Ba, Ata ug IlegalArgumentException 异常 而 不 是 从 
weekInMonthToString 和 relativeToString 返 回 错误 字符 串 ， 第 417 行 和 429 
行 的 测试 也 能 通过 。 

做 出 这 些 修改 后 ， 所 有 的 单元 测试 都 通过 了 ， 我 确信 SerialDate I 
下 可 以 工作 。 是 时 候 让 它 “ 做 对 ”了 o 


16.2 证 它 做 对 


我 们 将 从 头 到 尾 遍 历 SerialDate， 同 时 加 以 改进 。 尽 管 在 本 草 的 讨 
论 中 你 看 不 到 这 个 过 程 ， 在 每 次 做 修改 后 ， 我 还 是 要 运行 全 部 
JCommon 单 元 测试 ， 包 括 我 为 SerialDate 改 进 的 那些 单元 测试 。 所 以 ， 
后 面 你 看 到 的 所 有 修改 ， 对 于 JCommon 都 是 可 工作 的 © 

从 第 1 行 开 始 ， 我 看 到 大 量 有 关 许 可 、 版 权 、 作 者 和 修改 历史 的 注 
释 。 我 明白 ,的确 有 些 法 律 事 宜 要 说 明 ， 所 以 版 权 和 许可 信息 应 该 保 


留 。 另 外 ， 修 改 历史 是 产生 于 19 世 纪 60 年 代 的 古董 ， 现 今 源 代码 控制 
工具 可 以 大 有 我们 做 到 这 个 。 应 该 删 掉 修 改 历 史 [C1]。 

从 第 61 行 开始 的 导入 列表 应 该 通过 使 用 java.text.* 和 java.util.* 来 缩 
短 。[J1] 

Javadoc 的 HTML 格 式 化 工作 (第 67 行 ) 令 我 旦 惧 。 一 个 源 文件 里 
面 有 多 种 语言 ， 我 有 点 发 恢 。 这 条 注释 有 4 种 语言 Java、 有 英文 、 
Javadoc 和 html[G1]。 有 那么 多 语言 ， 就 很 难 直截了当 。 例 如 ， 生 成 
Javadoc 后 ， 第 71 行 和 72 行 原本 很 好 的 位 置 就 丢失 了 ， 而 且 谁 想 在 源 代 
码 中 看 到 <ul> 和 <li> 这 样 的 东西 呢 ? 更 好 的 策略 可 能 是 用 <pre> 标 签 把 
整个 注释 部 分 包围 起 来 ， 这 样 ， 对 于 源 代码 的 格式 化 只 会 限于 Javadoc 
ZIL ° 

第 86 行 是 类 声明 。 这 个 类 为 何 要 命名 为 SerialDate? Serial 一 词 有 什 
么 妙 处 吗 ? 是 不 是 因为 该 类 派生 自 Serializable? 看 来 不 是 这 样 的 。 

别 猿 了 ， 我 知道 为 什么 (或 者 我 认为 自己 知道 ) 何以 要 用 Serial 一 
词 。 线 索 就 在 位 于 第 98 行 和 101 行 的 常量 SERIAL LOWER BOUND fill 
SERIAL UPPER BOUND。 更 好 的 线索 在 从 第 830 行 开始 的 注释 中 。 该 
类 被 命名 为 SerialDate， 是 因为 它 用 “序列 数 ”(serial number) 来 实现 ， 
该 系列 数 恰好 是 从 1899 年 12 月 30 日 后 的 天 数 。 

对 此 我 有 两 个 问题 。 首 先 ， 术 语 “ 序 列 数 ”* 并 不 真 对 。 可 能 有 点 诡 
淳 ， 但 其 呈现 方式 却 更 接近 相对 偏 移 其 于 序列 数 。 术 语 “ 友 列 数 ” 更 多 
地 用 于 产品 版 本 标识 ， 而 非 日 期 标识 。 我 没 发现 这 个 名 称 特 别 有 描 述 
力 [N1]。 更 有 描述 力 的 术语 大 概 是 “顺序 ”(ordinal) © 

第 二 个 问题 更 突出 。 名 称 SerialDate 暗示 了 一 种 实现 。 该 类 是 个 抽 
象 类 。 没 必要 暗示 任何 有 关 实 现 的 事 。 实 际 上 ， 没 理由 隐藏 实现 ! 我 
发 现 这 个 名 称 放 在 了 不 正确 的 抽象 层级 上 [N2]。 以 我 之 见 ， 该 类 的 名 
称 应 该 殴 是 简单 的 Date。 


NeW, Java FE BRAKE Daten f, Arex At Ae 
最 好 的 名 称 。 因 为 这 个 类 是 天 于 日 期 而 非 时 间 ， 我 想 将 其 命名 为 Day， 
但 这 个 名 字 也 在 多 处 被 得 用 。 最 后 ， 我 选 了 DayDate 作 为 最 佳 打 识 方 
案 o 

从 现在 起 ， 我 将 使 用 术语 DayDate。 请 记 住 ， 你 读 到 的 代码 清单 ， 
还 是 用 的 SerialDate。 

我 理解 为 何 DayDate 继承 目 Comparable 和 Serializable。 不 过 ， 为 
什么 它 要 继承 和 目 MonthConstants 呢 ? 类 MonthConstants 〈《 见 代码 清单 B- 
3) 只 是 一 大 堆 定义 了 月 份 的 静态 常量 。 从 常量 类 继承 是 Java 程 序 员 用 
的 一 种 老 花 招 ， 这 样 他 们 就 能 避免 形 如 MonthConstants.January 的 表达 
式 ， 不 过 这 是 个 坏 主意 [J2]。MonthConstants 其 实 应 该 是 个 枚 举 。 


public abstract class DayDate implements Comparable, 


Serializable ( 

public static enum Month 1 
JANUARY(1), 

FEBRUARY (2), 

MARCH(3), 

APRIL(4), 

MAY(5), 

JUNE(6), 

JULY(7), 

AUGUST(8), 

SEPTEMBER(9), 

OCTOBER(10), 

NOVEMBER(11), 

DECEMBER(12); 

Month(int index) 1 


this.index - index; 
} 
public static Month make(int monthIndex) { 
for (Month m : Month.values()) { 
if (m.index == monthIndex) 
return m; 
} 
throw new IllegalArgumentException("Invalid month index " + 
monthIndex); 
public final int index; 
} 
} 
把 MonthConstants 改 成 枚 举 ， 导 致 对 DayDate 类 和 用 到 这 个 类 的 代 
码 的 一 些 修改 。 我 从 了 一 个 小 时 来 改 代 码 。 不 过 ， 原 来 以 int 为 月 份 类 
型 的 函数 ， 现 在 都 用 上 Month 枚 举 元 素 了 。 这 意味 着 我 们 可 以 去 除 
isValidMonthCode 方 法 〈 第 326 行 ) ， 以 及 monthCodeToQuarter 等 位 置 的 
月 份 代 码 错 误 检 查 (第 356 行 ) 了 [G5] ° 
下 一 步 ， 我 们 看 到 第 91 行 ，serialVersionUID。 该 变量 用 于 控制 序 
列 号 。 如 采 我 们 修改 了 它 ， 用 这 个 软件 编写 的 旧版 本 DayDate 都 将 不 再 
可 用 ， 而 是 返回 一 个 InvalidClassException 异常。 如 果 你 没有 声明 
serialVersionUID 变 量 ， 则 编译 怖 会 目 动 生成 一 个 ， 每 次 修改 模块 时 都 
会 得 到 不 一 样 的 值 。 我 知道 ， 所 有 的 文档 都 建议 手工 控制 这 个 变量 ， 
但 对 我 来 说 自动 控制 序列 号 安全 得 多 [G4]。 我 宁肯 调试 
InvalidClassException, 15/8 N B GN ic 1B PX serial VersionUID 5| 
起 的 后 续 工 作 。 所 以 ， 我 要 删除 这 个 变量 一 一 至 少 暂时 这 么 做 [2]。 
我 发 现 第 93 行 的 注释 是 多 余 的 。 这 正 是 说 言 和 误导 信息 所 在 之 地 
[C2]。 所 以 我 要 干掉 它 和 它 的 同类 。 


第 97 行 和 100 行 的 注释 有 关 序 列 数 ， 我 之 前 已 经 讨论 过 这 个 问题 
[C1]。 它 们 描述 的 变量 是 DayDate 能 够 描述 的 最 早 和 最 后 的 日 期 。 这 可 
以 搞 得 更 清楚 些 [N1]。 

public static final int EARLIEST. DATE ORDINAL = 2; // 1/1/1900 

public static final int LATEST DATE ORDINAL = 2958465; // 
12/31/9999 

我 不 太 清 楚 为 什么 EARLIEST_DATE_ORDINAL 是 2 而 不 是 0。 在 第 
829 行 的 注释 中 有 个 提示 ， 说 明 这 与 用 Microsoft Excel 展 示 日 期 的 方式 
有 关 。 在 DayDate 的 派生 类 SpredsheetDate 中 能 看 得 更 深入 ( 见 代 码 清 单 
B-5) 。 第 71 行 的 注释 很 好 地 描述 了 这 个 问题 。 

我 的 问题 是 ， 这 看 来 应 该 与 SpreadsheetDate 有 关 ， 与 DayDate 无 关 
A opp a BI Li a EARLIEST DATE ORDINAL 和 
LATEST DATE ORDINAL 实在 不 该 属于 DayDate， 应 该 移 到 
SpreadSheeDate 中 [G6] ° 

的 确 ， 搜 索 一 下 代码 束 知 道 ， 这 些 变 量 值 仅 在 SpreadSheetDate 中 
用 到 。DayDate 中 没 用 到 ，JCommon 框 架 的 其 他 类 中 也 没有 用 。 所 以 ， 
我 将 把 它们 辐 下 移 到 SpreadSheetDate 中 。 

下 面 两 个 变量 ， MINIMUN YEAR SUPPORTED 和 
MAXIMUM YEAR SUPPORTED (5104777110717) E rj, ° E 
然 ， 如 果 DayDate 是 个 没有 提供 实现 铺垫 的 抽象 类 ， 它 就 不 该 告知 我 们 
有 关 最 小 和 最 大 年 份 的 信息 。 同 样 ， 我 很 想 把 这 些 变 量 向 下 移 到 
SpreadSheetDate 中 [G6]。 然 而 ， 快 速 查找 这 些 变 量 的 使 用 情况 ， 会 发 现 
男 一 个 类 也 在 用 : RelativeDayOfWeekRule ( 见 代 码 清 单 B-6) 。 在 第 
177 行 和 178 行 ，getDate 芳 数 中 ， 它 们 被 用 来 检查 getDate 的 年 份 参数 是 
否 有 效 。 抽 象 类 的 用 户 需 要 得 知 其 实现 信息 ， 这 是 个 矛盾 。 

我 们 要 做 的 是 既 提 供 信息 ， 又 不 污染 DayDate。 通 第， 我 们 会 从 派 
生 类 实体 中 获取 实现 信息 。 不 过 ， 并 未 同 getDate 函数 传 入 DayDate 的 


实体 ， 反 而 返回 了 这 么 一 个 实体 。 这 意味 着 必须 在 某 处 创建 实体 。 第 
187 ~ 20547 fe th T R ° DayDate C I & f£ getPreviousDayOfWeek ^ 
getNearestDayOfWeek 或 getFollowingDayOfWeek 这 三 个 函数 其 中 之 一 
里 面 创建 的 。 看 回 DayDate 代 码 清单 ， 我 们 看 到 ， 这 些 函 数 (58638— 
724 行 全 都 返回 了 由 addDays (第 571 行 ) 创建 的 日 期 实体 ，addDays 
调用 CreateInstance (5880817) , ， 创 建 出 一 个 SpreadSheetDate! [G7] ° 

通常 来 说 ， 基 类 不 宜 了 解 其 派生 类 的 情况 。 为 了 修正 这 个 毛病 ， 
我 们 应 该 利用 抽象 工厂 模式 (ABSTRACT FACTORY) [3]， 创 建 一 个 
DayDateFactory。 该 工厂 将 创建 我 们 所 需要 的 DayDate 的 实体 ， 并 回答 
有 关 实 现 的 问题 ， 例 如 最 大 和 最 小 日 期 之 类 。 

public abstract class DayDateFactory 1 


private static DayDateFactory factory = new 
SpreadsheetDateFactory(); 

public static void setInstance(DayDateFactory factory) { 

DayDateFactory.factory = factory; 

} 

protected abstract DayDate _makeDate(int ordinal); 

protected abstract DayDate _makeDate(int day, DayDate.Month 
month, int year); 

protected abstract DayDate _makeDate(int day, int month, int year); 

protected abstract DayDate _makeDate(java.util.Date date); 

protected abstract int. getMinimumYear(); 

protected abstract int. getMaximumYear(); 

public static DayDate makeDate(int ordinal) { 


return factory._makeDate(ordinal); 


public static DayDate makeDate(int day, DayDate.Month month, int 
year) 1 
return factory. makeDate(day, month, year); 
} 
public static DayDate makeDate(int day, int month, int year) { 
return factory._makeDate(day, month, year); 
} 
public static DayDate makeDate(java.util.Date date) { 
return factory._makeDate(date); 
} 
public static int getMinimum Year() { 
return factory._getMinimum Year(); 
} 
public static int getMaximumYear() 1 


return factory._getMaximum Year(); 


} 

该 工 六 类 用 makeDate 方 法 奉 代 了 createInstance 方 法 ， 前 者 的 名 称 稍 
好 一 些 [N1]。 在 初始 状态 下 ， 它 使 用 SpreadsheetDateFactory， 但 随时 可 
以 使 用 其 他 工厂 。 委 托 到 抽象 方法 的 静态 方法 混合 采用 了 单 件 模式 

(SINGLETON) 、 油 漆 工 模式 [4] 和 抽象 工厂 模式 [5]， 我 发 现 这 种 手 
段 很 有 用 。 
SpreadsheetDateFactory 看 起 来 像 这 个 样子 : 
public class SpreadsheetDateFactory extends DayDateFactory 1 
public DayDate _makeDate(int ordinal) { 


return new SpreadsheetDate(ordinal); 


public DayDate _makeDate(int day, DayDate.Month month, int year) 


return new SpreadsheetDate(day, month, year); 
} 
public DayDate _makeDate(int day, int month, int year) { 
return new SpreadsheetDate(day, month, year); 
} 
public DayDate _makeDate(Date date) { 
final GregorianCalendar calendar = new GregorianCalendar(); 
calendar.setTime(date); 
return new SpreadsheetDate( 
calendar.get(Calendar. DATE), 
DayDate.Month.make(calendar.get(Calendar. MONTH) + 1), 
calendar.get(Calendar. YEAR)); 
} 
protected int. getMinimumYear() 1 
return SpreadsheetDate. MINIMUM YEAR, SUPPORTED; 
} 
protected int _getMaximum Year() { 
return SpreadsheetDate. MAXIMUM YEAR, SUPPORTED; 


} 

如 你 所 见 ， 我 已 经 把 MINIMUM YEAR SUPPORTED 和 
MAXIMUM YEAR SUPPORTED 变量 移 到 了 它们 该 在 的 
SpreadsheetDate'F[G6] ° 

DayDate 的 下 一 人 1 2 ana ae 这 些 常 量 其 实 应 该 
是 枚 举 [J3]。 我 们 之 前 见 过 这 种 模式 ， 不 再 性 述 。 你 可 以 在 最 终 的 代码 


清单 中 看 到 。 

跟着 ， 我 们 看 到 第 140 行 一 系列 以 LAST_DAY_OF_MONTH 开 头 的 
数组 。 首 先 ， 描 述 这 些 数组 的 注释 全 属 多 余 [C3]。 光 看 名 称 就 够 了 。 所 
以 我 要 删除 这 些 注 释 。 

这 个 数组 没 理由 不 是 私有 的 [G8] ， 因 为 有 个 静态 函数 
lastDayOfMonth 提 供 同 样 的 数据 。 

下 一 个 数组 AGGREGATE_DAYS_TO_END_OF_MONTH 更 神秘 
一 些 ， 在 JCommon 框架 中 根本 没 用 到 它 [G9]。 所 以 我 直接 删除 了 。 

对 于 LEAP_YEAR_AGGREGATE_DAYS_TO_END_OF_MONTH 世 
= 

AGGREGATE DAYS TO END OF PRECEDING MONTH 只 在 
SpreadsheetDate 中 用 到 ( 8 43477 41473747) » © RIE T SJ 
SpreadsheetDate 中 去 是 个 问题 。 不 转移 的 理由 是 ， 该 数组 并 不 专属 于 任 
何 特定 的 实现 [G6]。 男 一 方面 ， 实 际 上 并 不 存在 SpreadsheetDate 之 外 的 
实现 ， 所 以 ， 数 组 应 该 移 到 靠近 其 使 用 位 置 的 地 方 [G10]。 

说 服 我 的 理由 是 保持 一 致 [G11]， 数 组 应 该 私有 ， 并 通过 类 似 
julianDateOfLastDayOfMonth 这 样 的 函数 来 又 露 。 看 来 没 人 需要 那样 的 
函数 。 而 且 ， 如 果 有 新 的 DayDate 实 现 需要 该 数组 ， 可 以 轻易 地 把 它 移 
回 到 DayDate 中 去 。 所 以 我 驶 把 它 移 到 SpreadsheetDate 里 面 了 。 

对 于 LEAP YEAR. AGGREGATE DAYS TO END OF MONTH. 
也 一 样 。 

跟着 ， 我 们 看 到 三 组 可 以 转换 为 枚 举 的 常量 (58162-20517) 

第 一 个 用 来 选择 月 份 中 的 一 周 。 我 将 其 转换 为 名 为 WeekInMonth 的 枚 


AS o 


public enum WeekInMonth { 
FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 


public final int index; 


WeekInMonth(int index) { 


this.index = index; 


} 

第 二 组 常量 〈 第 177 一 187 行 ) 有 点 麻烦 。INCLUDE_NONE ^ 
INCLUDE_FIRST、INCLUDE_SECOND 和 INCLUDE_BOTH 常 量 用 于 
描述 某 个 范围 的 终止 日 是 否 包 含 在 该 范围 之 内 。 数 学 上 ， 用 术语 “开放 
区 间 ”、“ 半 开放 区 间 ” 和 “闭合 区 间 ” 来 表示 。 我 想 ， 用 数学 术语 来 命名 
会 更 清晰 [N3]， 所 以 就 将 其 转换 为 枚 举 DateInterval ， 其 中 包括 
CLOSED、CLOSED_LEFT、CLOSED_RIGHT 和 OPEN 枚 举 元 素 。 

第 三 组 常量 (182057) 描述 了 是 否 该 在 最 后 、 下 一 个 或 最 近 
的 日 期 实体 中 呈现 对 某 个 星期 的 特定 一 天 的 查找 结果 。 怎 么 命名 是 个 
难题 。 最 终 ， 我 给 WeekdayRange 设 定 了 LAST、NEXT 和 NEAREST 枚 

你 也 许 不 会 同意 我 取 的 名 字 。 对 我 而 言 这 些 名 字 有 意义 ， 但 对 你 
可 能 束 不 然 。 要 点 是 它们 眼下 变 成 了 易于 修改 的 形式 [J3]。 不 再 以 整数 
形式 传递 ， 而 是 作为 符号 传递 。 我 可 以 用 IDE 的 “修改 和 名称” 功能 来 改动 
名 称 或 类 型 ,无需 担忧 漏 掉 代码 中 某 处 -1 或 2 之 类 的 数字 ， 也 不 必 担 忧 
某 些 int 参 数 声 明 人 处 于 摘 述 不 佳 的 状态 。 

第 208 行 的 描述 字段 看 来 没有 任何 地 方 用 到 。 我 把 它 及 其 取 值 器 和 
RE aS HD TE f 。 

我 还 删除 了 第 213 行 的 默认 构造 器 [G12]。 Fae eA Fel] EI TE 
成 的 。 

略 过 isValidWeekdayCode 方 法 (%216—23877) ， 在 创建 Day 枚 举 
时 已 经 把 它 删 掉 了 。 

于 是 来 到 stringToWeekdayCode 方 法 (58242-27017) 。 没 有 方法 
签名 增添 价值 的 Javadoc 都 是 废话 [C3]、[G12]， 唯 一 的 价值 是 对 返回 值 


— 1A fat e Ai, AAMC f Days, AER SCS IR T 
[C2]。 该 方法 现在 抛 出 一 个 IlegalArgumentException 异 常 。 所 以 我 删除 
T Javadoc ° 

ROMER T SAM EE IN ea final KES Ri, ENS 
无 价值 ， 空 自 混 消 视 听 惑 [G12]。 删 除 这 些 final ， 不 合 某 些 成 例 。 例 
如 ，Robert Simmons[6] 就 强烈 建议 我 们 “.……. TE RAS Fol Ti final o "RA 
能 奇 同 。 我 认为 ，final 有 少数 的 好 用 法 ， 例 如 偶尔 使 用 的 final 利 量 ， 但 
除 此 之 外 该 天 键 字 利 小 于 整 。 我 这 么 认为 ， 或 许 是 因为 final 可 能 捕获 到 
的 那些 错误 类 型 ， 早 已 被 我 编写 的 蛙 元 测试 捕获 了。 

我 不 喜欢 for 循 环 (第 259 行 和 263 行 中 的 那些 f 语 句 [G5]， 所 以 我 
利用 |» 操作 符 把 它们 连接 为 单个 ff 语句 。 我 还 使 用 Day 枚 举 整 理 for 循 
环 ， 做 了 一 些 装饰 性 的 修改 。 

我 认为 ， 这 个 方法 并 不 真 属于 DayDate 类 。 它 其 实 是 Day 的 一 个 解 
析 范 数 。 所 以 ， 我 将 它 移 到 Day 枚 举 中 。 不 过 ， 那 样 Day 枚 举 就 会 变 得 
太 大 。 因 为 Day 的 概念 并 不 依赖 于 DayDate ， 我 就 把 Day 枚 举 移 到 
DayDate 类 之 外 ， 放 到 它 自 己 的 源 代码 文件 中 。 

我 还 把 下 一 个 函数 ，weekdayCodeToString (5$8272— 28617) , % 
植 到 Day 枚 举 中 ， 称 其 为 toString 。 

public enum Day 1 

MONDAY (Calendar. MONDAY ), 
TUESDAY (Calendar. TUESDAY), 
WEDNESDAY (Calendar. WEDNESDAY ),s 
THURSDAY (Calendar. THURSDAY), 
FRIDAY (Calendar.FRIDAY ), 
SATURDAY(Calendar.S ATURDAY), 
SUNDAY(Calendar.SUNDAY); 


public final int index; 


private static — DateFormatSymbols dateSymbols = new 
DateFormatSymbols(); 

Day(int day) { 

index = day; 

j 


public static Day make(int index) throws IllegalArgumentException 


for (Day d : Day.values()) 
if (d.index == index) 
return d; 
throw new IllegalArgumentException( 
String.format("Illegal day index: %d.", index)); 
} 
public static Day parse(String s) throws IllegalArgumentException 1 
String[] shortWeekdayNames = 
dateSymbols.getShortWeekdays(); 
String[] weekDayNames = 
dateSymbols.getWeekdays(); 
s = s.trim(); 
for (Day day : Day.values()) { 
if (s.equalsIgnoreCase(shortWeekdayNames[day.index]) || 
s.equalsIgnoreCase(weekDayNames[day.index])) { 
return day; 
} 
} 
throw new IllegalArgumentException( 


String.format("%s is not a valid weekday string", s)); 


} 
public String toString() { 

return dateSymbols.getWeekdays()[index]; 
} 

} 

AMA getMonth i (58288-31647) 。 第 一 个 函数 调用 第 二 个 
国 数 。 第 二 个 函数 只 被 第 一 个 函数 调用 。 所 以 ， 我 把 这 两 个 函数 合 二 
为 一 ， 而 且 极 大 地 简化 之 [G9][G12][F4]。 最后， 我 把 名 称 修改 得 更 具 
目 我 描述 力 [N1]。 

public static String[] getMonthNames() 1 

return dateFormatSymbols.getMonths(); 

j 

由 于 有 了 Month 枚 举 ， 画 数 isValidMonthCode (58326-34617) W 
变 得 没什么 用 ， 所 以 我 把 它 删 除了 [G9] 。 

E 2X monthCodeToQuarter ( È 356 ~ 375 行 ) 有 特性 依恋 

(FEATURE ENVY) [7] 的 味道 ， 可 以 是 Month 枚 举 中 的 一 个 名 为 
quarter NIE, RAXAT ° 
public int quarter() { 
return 1 + (index-1)/3; 

j 

这 样 一 来 ，Month 枚 举 惑 大 到 需要 放 到 目 己 的 类 中 了 。 我 把 它 从 
DayDate 中 移出 来 ， 与 Day 枚 举 保 持 一 致 [G11][G13]。 

下 两 个 方法 被 命名 为 monthCodeToString (#377—42617) 。 我 们 
再 次 看 到 其 中 一 个 方法 使 用 标识 调用 其 兄 第 方法 的 模式 。 将 标识 作为 
参数 传递 给 函数 的 做 法 通 稼 不 太 好 ， 尤 其 是 当 该 标识 只 是 有 天 其 输出 
格式 时 [G15]。 我 重 命名 、 人 简化 、 重 新 构架 了 这 些 函 数 ， 并 把 它们 移 到 
Month 枚 举 中 [N1][N3][G14] ° 


public String toString() 1 

return dateFormatSymbols.getMonths()[index - 1]; 
} 
public String toShortString() { 

return dateFormatSymbols.getShortMonths()[index - 1]; 
} 
下 一 个 方法 是 stringToMonthCode (#428—47277) 。 我 重新 为 它 

命名 ， 转 移 到 Month 枚 举 中 ， 并 且 简 化 之 [N1][N3][C3][G14][G12]。 

public static Month parse(String s) 1 

s = s.trim(); 

for (Month m : Month.values()) 

if (m.matches(s)) 
return m; 
try 1 
return make(Integer.parseInt(s)); 

} 

catch (NumberFormatException e) {} 

throw new IllegalArgumentException("Invalid month " + s); 
} 
private boolean matches(String s) { 

return s.equalsIgnoreCase(toString()) || 

s.equalsIgnoreCase(toShortString()); 
} 
È ikisLeapYear ($ 495~51777) 可 以 写 得 更 具 表 达 力 一 些 
[G16] ° 


public static boolean isLeapYear(int year) { 


boolean fourth = year % 4 == 0; 


boolean hundredth = year 96 100 == 0; 
boolean fourHundredth = year 96 400 == 0; 
return fourth && (!hundredth || fourHundredth); 

} 

下 一 个 函数 leapYearCount (48519~536/T) 并 不 真 属 于 DayDate ° 
除了 SpreadsheetDate 中 的 两 个 方法 外 ， 没 有 其 他 调用 者 。 所 以 我 将 它 往 
INI 

E 数 lastDayOfMonth (第 538 ~ 560 fr ) 使 用 了 
LAST_DAY_OF_MONTH 数 组 。 该 数组 应 该 隶属 于 Month 枚 举 [G17]， 
所 以 我 承 把 它 移 到 那儿 去 了 。 我 还 简化 了 这 个 函数 ， 使 其 更 具 表 达 力 
[G16] ° 

public static int lastDayOfMonth(Month month, int year) { 

if (month == Month.FEBRUARY && isLeapYear(year)) 


return month.lastDay() + 1; 


else 
return month.lastDay(); 
} 
现在 ， 事 情 变 得 比较 有 趣 一 些 了 。 下 一 个 函数 是 addDays (58562 
757643) 。 首 先 ， 由 于 该 函数 对 DayDate 的 变量 进行 操作 ， 它 就 不 该 
是 静态 的 [G18]。 所 以 ， 我 把 它 修 改 为 实体 方法 。 其 次 ， 它 调用 了 函数 
toSerial。 这 个 函数 应 该 重新 命名 为 toOrdial [IN1]。 最 后 ， 该 方法 可 以 简 
化 。 
public DayDate addDays(int days) 1 
return DayDateFactory.makeDate(toOrdinal() + days); 
} 
对 于 addMonth (5578—60277) 也 一 样 。 它 应 该 是 个 实体 方法 
[G18]。 算法 太 过 复杂 ， 所 以 我 利用 解释 临时 变量 模式 (EXPLAINING 


TEMPORARY VARIABLES) [8] 来 使 其 更 为 透明 。 我 还 将 方法 getYYY 
重 命名 为 getYear [N1] ° 
public DayDate addMonths(int months) { 
int thisMonthAsOrdinal = 12 * getYear() + getMonth().index - 1; 
int resultMonthAsOrdinal = thisMonthAsOrdinal + months; 
int resultYear = resultMonthAsOrdinal / 12; 
Month resultMonth = Month.make(resultMonthAsOrdinal 96 12 + 1); 


int  lastDayOfResultMonth = . lastDayOfMonth(resultMonth, 
resultYear); 

int resultDay = Math.min(getDayOfMonth(), 
lastDayOfResultMonth); 

return DayDateFactory.makeDate(resultDay, resultMonth, 
resultYear); 


j 
对 于 函数 addYear (58604— 62617) 也 照 方 办 理 。 
public DayDate plusYears(int years) 1 
int resultYear = getYear() + years; 
int lastDayOfMonthInResultYear = lastDayOfMonth(getMonth(), 
resultYear); 
int resultDay = Math.min(getDayOfMonth(), 
lastDayOfMonthInResult Year); 
return DayDateFactory.makeDate(resultDay, getMonth(), result Year); 
} 
把 这 些 方法 从 静态 方法 变 为 实体 方法 ， 证 我 有 点 心头 发 痒 。 用 
date.addDays(5) 这 样 的 表达 方法 ， 是 不 是 明确 地 表示 了 date 对 象 并 没 变 
动 以 及 返回 了 一 个 DayDate 的 新 实体 呢 ? 或 者 ， 它 只 是 错误 地 暗示 我 们 


往 date 对 象 添 加 了 5 天 呢 ? 你 可 能 不 会 认为 这 是 个 大 问题 ， 但 下 列 代码 
却 可 能 会 有 欺骗 性 。 

DayDate date = DateFactory.makeDate(5, Month.DECEMBER, 1952); 

date.addDays(7); // bump date by one week. 

有 些 读 到 这 段 代码 的 人 会 认为 addDays 在 修改 date 对 象 。 所以， 我 
们 需要 消除 这 种 卜 义 的 名 称 [N4]。 我 把 名 称 改 为 plusDays 和 
plusMonths。 我 认为 ， 方 法 的 初衷 很 清楚 地 被 

DayDate date = oldDate.plusDays(5); 

所 体现 ， 不 过 下 列 代码 对 认为 date 对 象 被 修改 的 读者 来 说 ， 看 起 来 
并 不 那么 顺畅 

date.plusDays(5); 

算法 越 来 越 有 趣 ，getPreviousDayOfWeek (第 628~660 行 ) 可 以 工 
作 ， 不 过 有 点 复杂 了 “。 经 过 一 番 思 考 ， 了 解 到 它 的 功能 后 [G21]， 我 瓯 
能 够 使 用 解释 临时 变量 模式 来 简化 它 [G19]， 使 其 更 为 清晰 。 我 还 将 它 
从 静态 方法 改 为 实体 方法 [G18]， 并 删除 了 重复 的 实体 方法 [G5] (58997 
~1008í7) ° 

public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 


int offsetToTarget = targetDayOfWeek.index - 
getDayOfWeek().index; 
if (offsetToTarget >= 0) 
offsetToTarget -= 7; 
return plusDays(offsetToTarget); 
5 
Xf getFollowingDayOfWeek (58662-69317) 也 如 法 炮制 : 
public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget = targetDayOfWeek.index - 
getDayOfWeek().index; 


if (offsetToTarget <= 0) 
offsetToTarget += 7; 
return plusDays(offsetToTarget); 

} 

下 一 个 函数 是 我 们 之 前 修改 过 的 getNearestDayOfWeek (*58695— 
726 行 ) 。 我 之 前 所 做 的 修改 和 前 两 个 函数 没有 保持 一 致 [G11]。 所 以 我 
将 它 改 得 和 这 两 个 函数 保持 一 致 ， 并 且 使 用 解释 临时 变量 模式 [G19] 来 
前 明 算法 。 

public DayDate getNearestDayOfWeek(final Day targetDay) { 

int offsetToThisWeeksTarget - targetDay.index - 
getDayOfWeek().index; 
int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) 96 7; 
int offsetToPreviousTarget = offsetToFutureTarget - 7; 
if (offsetToFutureTarget > 3) 
return plusDays(offsetToPrevious Target); 
else 
return plusDays(offsetToFutureTarget); 

} 

方法 getEndOfCurrentMonth ($728—74077) 有 点 奇怪 ， 因 为 它 获 
取 了 DayDate 参 数 ， 从 而 成 为 一 个 依恋 [G14] 其 自身 类 的 实体 方法 。 我 
将 其 改 为 真正 的 实体 方法 ， 并 修改 了 几 个 名 称 。 

public DayDate getEndOfMonth() 1 

Month month = getMonth(); 


int year = getYear(); 
int lastDay = lastDayOfMonth(month, year); 
return DayDateFactory.makeDate(lastDay, month, year); 


重 构 weekInMonthToString (58742--76117) 的 过 程 非常 有 趣 。 利 
用 IDE 的 重 构 工具 ， 我 先 将 其 移 到 我 之 前 创建 的 WeekInMonth 枚 举 中 ， 
再 将 其 重 命名 为 toString。 跟 着 ， 我 把 它 从 静态 方法 改 为 实体 方法 。 所 
有 的 测试 都 通过 了 “。 (你 能 猜 出 来 我 打算 做 什么 吗 ? ) 
接 下 来 ， 我 删 掉 了 整个 方法 ! 有 5 个 断言 失败 了 (41141541F, 
代码 清单 B-4) 。 我 改动 了 这 些 代码 行 ， 让 它们 使 用 枚 举 元 素 的 名 称 
(FIRST ^ SECOND......) 。 全 部 测试 都 通过 了 。 你 知道 为 什么 吗 ? 你 
能 否 知道 为 什么 这 些 步 又 都 是 必要 的 吗 ? 重 构 工具 确保 之 前 对 
weekInMonthToString 方 法 的 调用 现在 都 调用 weekInMonth 枚 举 元 素 的 
toString 方 法 ， 全 部 枚 举 元 素 都 以 返回 其 名 称 的 形式 实现 了 toString 方 


我 不 季 有 点 聪明 过 头 了 。 这 一 套 美 妙 的 重 构 下 来 ， 我 终于 意识 
到 ， 这 个 函数 的 唯一 调用 者 ， 束 是 我 刚 修 改 的 测试 ， 所 以 我 删除 了 这 
些 测试 。 

昌 我 一 次 ， 是 你 之 耻 。 轴 我 两 次 ， 是 我 之 耻 ! 所 以 ， 在 判定 除了 
测试 之 外 没有 人 调用 过 relativeToString (#765—78117) 后 ， 我 就 删除 
TRB AMZ > 

我 们 最 后 将 其 改 为 这 个 抽象 类 的 抽象 方法 。 第 一 个 函数 保持 了 原 
FÉ: toSerial 〈 第 838 一 844 行 ) 。 前 文 我 曾 把 名 称 改 为 tcOrdinal。 以 现 
在 的 情形 看 ， 我 决定 应 该 把 名 称 改 为 getOrdinalDay ° 

下 一 个 抽象 方法 是 toDate 〈 第 838 一 844 行 ) 。 它 将 DayDate 转 换 为 
java.util.Date。 这 个 方法 为 何 是 抽象 的 ? 碍 看 其 在 SpreadsheetDate 中 的 
实现 (第 198~~207 行 ， 代 码 清单 B-5) ， 可 以 看 到 它 并 不 依赖 于 该 类 的 
实现 [G6]。 所 以 ， 我 把 它 往 上 推 了 。 

方法 getYYYY、getMonth 和 getDayOfMonth 已 经 是 抽象 方法 。 不 
过 ，getDayOfWeek 方 法 是 男 一 个 应 该 从 SpreadsheetDate 中 提出 来 的 方 
法 ， 因 为 它 不 依赖 于 DayDate 之 外 的 东西 [G6]。 是 这 样 吗 ? 


仔细 阅读 〈 第 247 行 ， 代 码 清单 B-5) ， 可 以 发 现 该 算法 暗中 依赖 
于 顺序 日 期 的 起 点 (换言之 ， 第 0 天 的 星期 日 数 ) 。 所 以 ， 即 便 该 方法 
没有 物理 上 的 依赖 ， 也 不 能 移 到 DayDate 中 ， 因 为 它 的 确 有 逻辑 上 的 依 
LU, 

这 样 的 逻辑 依赖 困扰 了 我 [G22]1。 如 果 有 什么 东西 在 逻辑 上 依赖 实 
现 的话 ， 也 该 有 什么 物理 上 的 依赖 存在 。 我 也 认为 ,算法 本 喘 也 该 有 
一 小 部 分 依赖 于 实现 。 

所 以 我 在 DayDate 中 创建 了 一 个 名 为 getDayOfWekForOrdinalZero 的 
抽象 方法 ， 并 在 SpreadsheetDate 中 实现 它 ， 返 回 Day.SATURDAY。 然 后 
我 把 getDayOfWeek 上 移 到 DayDate 中 ， 并 调用 getOrdinalDay 和 
getDayOf WeekForOrdinal Zero ° 

public Day getDayOf Week() { 

Day startingDay = getDayOfWeekForOrdinalZero(); 


int startingOffset = startingDay.index - Day.SUNDAY.index; 
return Day.make((getOrdinalDay() + startingOffset) 96 7 + 1); 

j 

顺便 说 一 句 ， 请 仔细 阅读 第 895~899 行 的 注释 。 这 样 的 重复 有 必 
要 吗 ? 通 前 ， 我 会 删除 这 类 注释 。 

下 一 个 方法 是 compare (45902~9134T) 。 同 样 ， 该 抽象 方法 是 不 
恰当 的 [G6]。 我 将 其 实现 上 移 到 DayDate。 其 名 称 也 不 足够 有 沟通 意义 
[N1]。 方 法 实际 上 返回 的 是 自 参数 日 期 以 来 的 天 数 ， 所 以 我 把 名 称 改 
为 daysSince。 我 还 注意 到 该 方法 没有 测试 ， 就 为 它 编写 了 测试 。 

下 面 6 个 函数 (58915-98017) 全 都 是 应 该 在 DayDate 中 实现 的 抽 
象 方 法 。 我 把 它们 全 都 从 SpreadsheetDate 中 抽出 来 了 。 

最 后 一 个 函数 isInRange (58982-99517) 也 需要 推 到 上 一 层 并重 
构 之 。 那 个 switch 语 句 有 扣 丑 隔 [G23]， 可 以 把 那些 条 件 判断 移 到 
DateInterval 枚 举 中 去 。 


public enum Datelnterval { 
OPEN ( 
public boolean isIn(int d, int left, int right) { 
return d > left && d « right; 
} 
li 
CLOSED_LEFT { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d < right; 
} 
}, 
CLOSED_RIGHT { 
public boolean isIn(int d, int left, int right) { 
return d > left && d <= right; 
} 
js 
CLOSED { 
public boolean isIn(int d, int left, int right) { 
return d >= left && d <= right; 
} 
l; 
public abstract boolean isIn(int d, int left, int right); 
} 
public boolean isInRange(DayDate d1, DayDate d2, DateInterval 
interval) { 
int left = Math.min(d1.getOrdinalDay(), d2.getOrdinalDay()); 
int right = Math.max(d1.getOrdinalDay(), d2.getOrdinalDay()); 


return interval.isIn(getOrdinalDay(), left, right); 

} 

我 们 来 到 了 DayDate 的 末尾 。 现 在 我 们 要 从 头 到 尾 再 过 一 次 ， 看 看 
整个 重 构 过 程 是 怎样 民 好 执行 的 。 

首先 ， 开 端 注释 过 时 已 久 ， 我 缩短 并 改进 了 它 [C2] 。 

然后 ， 我 把 全 部 枚 举 移 到 它们 自己 的 文件 中 [G12] 。 

跟着 ， 我 把 静态 变量 (dateFormatSymbols) 和 3 个 静态 方法 

(getMonthNames、isLeapYear 和 ]astDayOfMonth) 移 到 名 为 DateUtil 的 
新 类 中 [G6] ° 

我 把 那些 抽象 方法 上 移 到 它们 该 在 的 顶层 类 中 [G24]。 

我 把 Month.make 改 为 Month.fromInt [N1]， 并 如 法 炮制 所 有 其 他 枚 
举 。 我 还 为 全 部 枚 举 创 建 了 toInt( ) 访 问 器 ， 把 index 字 上 段 改 为 私有 。 

在 plusYears 和 plusMonths 中 存在 一 些 有 趣 的 重复 [G5]， 我 通过 抽 离 
出 名 为 correctLastDayOfMonth 的 新 方法 消解 了 重复 ， 使 这 3 个 方法 清晰 
多 了 。 

我 消除 了 魔术 数 1 [G25] ， 用 MonthJANUARYtomt( ) 或 
Day.SUNDAY.toInt( t T tA ABE è JEfESpreadsheetDate 上 花 了 点 时 
则 ， 清 理 了 一 下 算法 。 最 终结 果 在 代码 清单 B-7~~ 16 中 。 

有 趣 的 是 ，DayDate 的 代码 覆盖 率 降 低 到 了 84.9%1! 这 并 不 是 因为 
测试 到 的 功能 减少 了 ， 而 是 因为 该 类 缩减 得 太 多 ， 导 人 致 少量 未 履 盖 到 
的 代码 行 拥有 了 更 大 权重 。DayDate 的 53 个 可 执行 语句 中 有 45 个 得 到 测 
试 履 盖 。 未 禾 盖 的 代码 行 微细 到 不 值得 测试 。 


16.3 小 结 


我 们 再 一 次 遵从 了 童子 军 军 规 。 我 们 签 入 的 代码 ， 要 比 签 出 时 整 
Ti TCA BORE T BIB, MIREI o DUAE mS I. xU 
了 一 些 缺陷 ， 代 码 清晰 并 缩短 了 “。 后 来 者 有 望 比 我 们 更 容易 地 应 付 这 
些 代码 。 他 也 有 可 能 把 代码 整理 得 更 干净 些 。 
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RE: 更 好 的 解决 方案 是 让 Javadoc 不 对 注释 做 格式 化 ， 这 样 注释 在 
代码 和 文档 中 吏 会 是 一 种 样式 。 


[2]. 原 注 : 本 对 的 好 几 个 审读 者 都 不 这 么 认为 。 他 们 主张 ， 在 开源 框架 
中 ， 手 工控 制 序列 ID 会 比较 好 ， 因 为 较 小 的 修改 不 会 导致 序列 化 后 的 
日 期 无 效 。 这 是 种 中 肯 的 观点 。 人 然而， 尽管 会 不 方便 ， 但 失败 束 会 有 
个 清晰 的 原因 。 男 一 方面 ， 如 果 该 类 的 作者 走 记 更 新 序列 ID， 则 失败 
模式 束 会 不 可 预期 ， 而 且 可 能 会 隐藏 得 很 深 。 我 认为 ， 这 个 故事 的 精 
散在 于 ， 不 应 该 跨 版 本 做 反 序列 化 处 理 。 


[3]. 原 注 : [GOF] ° 


(4) JRE: Ibid ° 
[5]. 原 注 : Ibid ° 


[6]. 原 注 : [Simmons04], p. 73 ° 
[7]. 537€: [Refactoring] ° 
[8]. 原 注 : [Beck97] ° 
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Martin Fowler E: & + Refectoring:Improving the Design of Existing 
Code[1] 中 指出 了 许多 不 同 的 “代码 味道 ”。 下 面 的 清单 包括 很 多 Martin 
提出 的 味道 ， 还 添加 了 更 多 我 目 己 提出 的 ， 也 包括 我 借以 历练 本 业 的 
其 他 珍宝 与 启发 。 

我 大 由 人 过 唤 和 重 构 几 个 不 同 的 程序 总 结 出 这 个 清单 。 每 次 修改 ， 
我 都 问 自 己 为 什么 要 这 样 改 ， 把 修改 的 原因 写 下 来 。 结 果 就 是 得 到 相 


当 长 的 清单 ， 给 出 在 读 代码 时 让 我 闻 起 来 不 舒服 的 味道 。 
清单 应 按 顺 序 阅读 ， 并 作为 一 种 参考 来 使 用 。 


17.1 注释 


C1: 不 恰当 的 信息 

让 注释 传达 本 该 更 好 地 在 源 代 码 控制 系统 、 问 题 妃 踩 系统 或 任何 
其 他 记录 系统 中 保存 的 信息 ， 是 不 恰当 的 。 例 如 ， 修 改 历史 记录 只 会 
用 大 量 过 时 而 无 趣 的 文本 摘 乱 源 代 码 文件 。 通 汕 ， 作 者 、 最 后 修改 时 
间 、SPR 数 等 元 数据 不 该 在 注释 中 出 现 。 注 释 只 应 该 描述 有 关 代码 和 设 
计 的 技术 性 信息 。 

C2: 废弃 的 注释 

过 时 、 无 天 或 不 正确 的 注释 就 古 废弃 的 注释 。 注 释 会 很 快 过 时 。 
最 好 别 编写 将 被 废 弃 的 注释 。 如 果 发 现 废弃 的 注释 ， 最 好 尽快 更 新 或 
删除 掉 。 废 弃 的 注释 会 远离 它们 曾经 描述 的 代码 ， 变 成 代码 中 无 关 和 
误导 的 浮 岛 。 

C3: 元 余 注释 

如 有 果 注 释 搞 述 的 是 某 种 充分 目 我 描述 了 的 东西 ， 那 么 注释 吏 是 多 
余 的 。 例 如 : 

i++; // increment i 

Fi — ^r | XE ERES EE BH ZIM ABA (或 少 说 ) 的 


Javadoc: 


/ 米 米 
* @param sellRequest 
* (greturn 


* @throws ManagedComponentException 


*/ 
public SellResponse beginSellItem(Sell Request sellRequest) 
throws ManagedComponentException 

注释 应 该 谈 及 代码 目 身 没 提 到 的 东西 。 

C4: FERRIER 

值得 编写 的 注释 ， 也 值得 好 好 写 。 如 末 要 编写 一 条 注释 ， 束 化 时 
间 保 证 写 出 最 好 的 注释 。 字 靶 句 酌 。 使 用 正确 的 语法 和 拼写 。 别 内 
it, EREE, TERI © 

C5: 注释 掉 的 代码 

看 到 被 注释 掉 的 代码 会 令 我 抓 狂 。 谁 知道 它 有 多 旧 ? 谁 知 道 它 有 
没有 意义 ? 没 人 会 删除 它 ， 因 为 大 家 都 假设 别人 需要 它 或 是 有 进一步 
计划 。 

那样 的 代码 就 这 样 腐烂 掉 ， 随 着 时 间 推 移 ， 越 来 越 与 系统 没 关 
系 。 它 调用 不 复 存 在 的 钞 数 。 它 使 用 已 改名 的 变量 。 它 遵循 已 侦 废 弃 
的 约定 。 它 污染 了 所 属 的 模块 ， 分 散 了 想 要 读 它 的 人 的 注意 力 。 注 释 
掉 的 代码 纯 属 厌 物 。 

看 到 注释 掉 的 代码 ， 就 删除 它 ! 别 担心 ， 源 代码 控制 系统 还 会 记 
得 它 。 如 果 有 人 真 的 需要 ， 可 以 签 出 较 前 的 版 本 。 别 被 它 搞 到 死去 活 
来 o 


17.2 环境 


El: 需要 多 步 才 能 实现 的 构建 
构建 系统 应 该 定单 步 的 小 操作 。 不 应 该 从 源 代码 控制 系统 中 一 小 
点 一 小 点 签 出 代码 。 不 应 该 需要 一 系列 神秘 指令 或 环境 依赖 脚本 来 构 


建 单个 元 素 。 不 应 该 四 处 寻找 额外 的 小 JAR、XML 文件 和 其 他 系统 所 
需 的 杂 物 。 你 应 当 能 够 用 单个 命令 签 出 系统 ， 并 用 单个 指令 构建 它 。 

svn get mySystem 

cd mySystem 

ant all 

E2: 需要 多 步 才 能 做 到 的 测试 

你 应 当 能 够 发 出 单个 指令 就 可 以 运行 全 部 单元 测试 。 能 够 运行 全 
部 测试 是 如 此 基础 和 重要 ， 应 该 快速 、 轻 易 和 直截了当 地 做 到 。 


17.3 函数 


F1: 过 多 的 参数 

函数 的 参数 量 应 该 少 。 没 参数 最 好 ， 一 个 次 之 ， 两 个 、 三 个 再 次 
之 。 三 个 以 上 的 参数 非常 值得 质疑 ， 应 坚决 避免 。 (参见 前 文 “ 范 数 参 
数 ” 一 节 。) 

F2: 输出 参数 

输出 参数 违反 直觉 。 读 者 期 望 参 数 用 于 输入 而 非 输 出 。 如 果 画 数 
非 要 修改 什么 东西 的 状态 不 可 ， 就 修改 它 所 在 对 象 的 状态 好 了 。 ( 参 
见 前 文 “输出 参数 ”一 节 。) 

布尔 值 参 数 大 声 宣告 画 数 做 了 不 止 一 件 事 。 它 们 令 人 迷惑 ， 应 
WKH. (参见 前 文 “标识 参数 ”一 节 。) 

F4: 死 函 数 

永 不 被 调用 的 方法 应 该 丢弃 。 保 留 死 代码 纯 属 浪费 。 别 害怕 删除 
函数 。 记 住 ， 源 代码 控制 系统 还 会 记得 它 。 


N 
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17.4 TRXTTIA 


G1: 一 个 源 文 件 中 存在 多 种 语言 

当今 的 现代 编程 环境 允许 在 单个 源 文 件 中 存在 多 种 不 同 语言 。 例 
如 ，Java 源 文件 可 能 还 包括 XML、HTML、YAML ` JavaDoc ^ 3X: ^ 
JavaScript 等 语言 。 另 例 ，JSP 文 件 可 能 还 包括 HTML、Java、 标 签 库 语 
TE > JR VERE ` Javadoc ` XML ` JavaScript 等 。 往 好 处 说 是 令 人 迷惑 ， 
TERA ERD ACR BERT e 

理想 的 源 文件 包括 且 只 包括 一 种 语言 。 现 实 上， 我 们 可 能 会 不 得 
不 使 用 多 于 一 种 语言 。 但 应 该 尽力 减少 源 文 件 中 额外 语言 的 数量 和 苑 
o 

G2: 明显 的 行为 未 被 实现 

遵循 “最 小 惊异 原则 ” (The Principle of Least Surprise) [2]， 画 数 或 
类 应 该 实现 其 他 程序 员 有 理由 期 待 的 行为 。 例 如 ， 考 虑 一 个 将 日 期 名 
称 翻 译 为 表示 该 日 期 的 枚 举 的 函数 。 

Day day = DayDate.StringToDay(String dayName); 

我 们 期 望 字符 串 Monday 翻 译 为 DayMONDAY。 我 们 也 期 望 常用 缩 
写 形式 也 能 补 翻 译 出 来 ， 我 们 还 期 待 琅 数 忽略 大 小 写 。 

如 果 明 显 的 行为 未 被 实现 ， 读 者 和 用 户 束 不 能 再 依 菲 他 们 对 函数 
名 称 的 和 直觉。 他们 不 再 信任 原作 者 ， 不 得 不 阅读 代码 细节 。 

G3: 不 正确 的 边界 行为 

代码 应 该 有 正确 行为 ， 这 话 看 似 明 日 。 问 题 是 我 们 很 少 能 明日 正 
VETT eT FAC S MINIMA, TELE C 
的 直觉 ， 而 不 是 努力 去 证 明代 码 在 所 有 的 角落 和 边界 情形 下 真能 工 
作 。 
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追 索 每 种 边 弄 条 件 ， 并 编写 测试 。 

G4: 忽视 安全 

切 尔 诺 贝 利 核电 站 崩塌 了 ， 因 为 电厂 经 理 一 条 又 一 条 地 忽视 了 安 
全 机 制 。 遵 守 安 全 就 不 便于 做 试验 。 结 果 就 是 试验 未 能 运行 ， 全 世界 
都 目 睛 首 个 民用 核电 站 大 灾难 。 

忽视 安全 相当 人 危险。 手工 控制 serialVersionUID 可 能 有 必要 ， 但 总 
会 有 风险 。 关 闭 某 些 编译 器 警告 (或 者 全 部 警告! ) 可 能 有 助 于 构建 
成 功 ， 但 也 存在 陷于 无 穷 无 尽 的 调试 鸭 风险 。 关 闭 失 败 测试 、 告 诉 自 
己 过 后 再 处 理 ， 这 和 假装 刷 信 用 卡 不 用 还 钱 一 样 坏 。 

G5: 重复 

有 一 条 本 书 提 到 的 最 重要 的 规则 之 一 ， 你 应 该 非常 严肃 地 对 待 。 
实际 上 ， 每 位 编写 有 天 软 件 设计 的 作者 都 提 到 这 条 规则 。Dave Thomas 
和 Andy Hunt 称 之 为 DRY 原 则 (Don't Repeat Yourself, 3]E& E c) 
[3]。Kent Beck 将 它 列 为 极限 编程 核心 原则 之 一 ， 并 称 之 为 “一 次 ， 也 
只 一 次 ”。Ron Jeffries 将 这 条 规则 列 在 第 二 位 ， 地 位 只 低 于 通过 所 有 测 
试 。 

每 次 看 到 重复 代码 ， 都 代表 遗漏 了 抽象 。 重复 的 代码 可 能 成 为 子 
程序 或 干脆 是 另 一 个 类 。 将 重复 代码 车 放 进 类 似 的 抽象 ， 增 加 了 你 的 
设计 语言 的 词汇 量 。 其 他 程序 员 可 以 用 到 你 创建 的 抽象 设施 。 编 码 变 
得 越 来 越 快 ， 错 误 越 来 越 少 ， 因 为 你 提升 了 抽象 层级 。 

重复 最 明显 的 形态 是 你 不 断 看 到 明显 一 样 的 代码 ， 丈 像 是 某 位 程 
序 员 疾 狂 地 用 鼠标 不 断 复制 粘贴 代码 。 可 以 用 单一 方法 来 奉 代 之 。 

较 隐 和 蔽 的 形态 是 在 不 同 模块 中 不 断 重复 出 现 、 检 测 同一 组 条 件 的 
switchy/case 或 if/else 链 。 可 以 用 多 态 来 奉 代 之 。 


更 隐蔽 的 形态 是 采用 类 似 算 法 但 具体 代码 行 不 同 的 模块 。 这 也 是 
一 种 重复 ， 可 以 使 用 模板 方法 模式 [4] 或 策略 模式 [5] 来 修正 。 

的 确 ， 过 去 15 年 内 出 现 的 多 数 设计 模式 都 是 消除 重复 的 有 名 手 
段 。 考 德 范式 (Codd Normal Forms) 是 消除 数据 库 规划 中 的 重复 的 策 
RS ° OO 目 身 也 古 组 织 模块 和 消除 重复 的 策略 。 受 不 出 奇 ， 结 构 化 编程 
也 是 。 

重点 已 经 在 那里 了 “。 尽 可 能 找到 并 消除 重复 。 

G6: 在 错误 的 抽象 层级 上 的 代码 

创建 分 离 较 高 层级 一 般 性 概念 与 较 低层 级 细节 概念 的 抽象 模型 ， 
这 很 重要 。 有 时 ， 我 们 创建 抽象 类 来 容纳 较 高 层级 概念 ， 创 建 派生 类 
来 容纳 较 低 层次 概念 。 这 样 做 的 时 候 ， 需 要 确保 分 离 完 整 。 所 有 较 低 
层级 概念 放 在 派生 类 中 ， 所 有 较 高 层级 概念 放 在 基 类 中 。 

例如 ， 只 与 细 市 实现 有 关 的 肖 量 、 变 量 或 工具 函数 不 应 该 在 基 类 
中 出 现 。 基 类 应 该 对 这 些 东 西 一 无 所 知 。 

这 条 规则 对 于 源 文 件 、 组 件 和 模块 也 适用 。 民 好 的 软件 设计 要 来 
分 离 位 于 不 同 层级 的 概念 ， 将 它们 放 到 不 同 容器 中 。 有 时， 这 些 容 右 
征 基 类 或 派生 类 ， 有 时 是 源 文 件 、 模 块 或 组 件 。 无 论 哪 种 情况 ， 分 离 
都 要 完整 。 较 低层 级 概念 和 较 高 层级 概念 不 应 混杂 在 一 起 。 看 看 下 面 
的 代码 : 


public interface Stack { 


Object pop() throws EmptyException; 

void push(Object o) throws FullException; 
double percentFull(); 

class EmptyException extends Exception {} 


class FullException extends Exception {} 


RRL percentFull 位 于 错误 的 抽象 层级 。 尺 管 存在 许多 在 其 中 “ 充 
满 ” (fullness) 概念 有 意义 的 Stack 的 实现 ， 但 也 有 其 他 不 能 知道 自己 有 
多 满 的 实现 存在 。 所 以 ， 该 男 数 最 好 是 放 在 类 似 BoundedStack 之 类 的 派 
ERRO o 

你 或 许 会 认为 ， 如 采 堆 栈 无 边界 ， 实 现 可 以 返回 0。 问 题 是 ， 不 存 
在 真 的 无 边界 的 堆栈 。 你 不 能 真 的 避免 在 做 以 下 检查 时 出 现 
OutOfMemoryException 异 和 常 : 

stack.percentFull() < 50.0. 

实现 返回 0 的 函数 可 能 是 在 撒谎 。 

要 点 是 你 不 能 就 错误 放置 的 抽象 模型 撒谎 。 孤 立 抽象 是 软件 开发 
者 最 难 做 到 的 事 之 一 ， 而 且 一 旦 做 错 也 没有 快捷 的 修复 手段 。 

将 概念 分 解 到 基 类 和 派生 类 的 最 普遍 的 原因 是 较 高 层级 基 类 概念 
可 以 不 依赖 于 较 低层 级 派生 类 概念 。 这 样 ， 如 采 看 到 基 类 提 到 派生 类 
名 称 ， 就 可 能 发 现 了 问题 。 通 常 来 说 ， 基 类 对 派生 类 应 该 一 无 所 知 。 

当然 也 有 例外 。 有 了 时， 派生 类 数量 严格 固定 ， 而 基 类 中 拥有 在 派 
生 类 之 间 选 择 的 代码 。 在 有 限 状 态 机 的 实现 中 这 种 情形 很 多 见 。 然 
而 ， 在 那 种 情况 下 ， 派 生 类 和 基 类 紧密 耦合 ， 总 是 在 同一 个 jar 文 件 中 
部 署 。 一 般 情 况 下 ， 我 们 会 想 要 把 派生 类 和 基 类 部 署 到 不 同 的 jar 文 件 
中 o 

将 派生 类 和 基 类 部 署 到 不 同 的 jar 文 件 中 ， 确 保 基 类 jar 文 件 对 派生 
类 jar 文 件 的 内 容 一 无 所 知 ， 我 们 就 能 把 系统 部 署 为 分 散 和 独立 的 组 
件 。 修 改 了 这 些 组 件 时 ， 不 必 重 新 部 署 基 组 件 就 能 部 署 它 们 。 这 意味 
着 修改 产生 的 影响 极 大 地 降低 了 ， 而 维护 系统 也 变 得 更 加 简单 。 

G8: 信息 过 多 

设计 良好 的 模块 有 着 非常 小 的 接口 ， 让 你 能 事半功倍 。 设 计 低 劣 
的 模块 有 着 广阔 、 深 入 的 接口 ， 你 不 得 不 事倍功半 。 设 计 民 好 的 接口 


并 不 提供 许多 需要 依靠 的 函数 ， 所 以 耦合 度 也 较 低 。 设 计 低劣 的 借口 
提供 大 量 你 必须 调用 的 函数 ， 耦 合 度 较 高 。 

优秀 的 软件 开发 人 员 学 会 限制 类 或 模块 中 暴露 的 接口 数量 。 类 中 
的 方法 越 少 越 好 。 画 数 知道 的 变量 越 少 越 好 。 类 拥有 的 实体 变量 越 少 
越 好 。 

隐藏 你 的 数据 。 隐 藏 你 的 工具 函数 。 隐 藏 你 的 常量 和 你 的 临时 变 
量 。 不 要 创建 拥有 大 量 方法 或 大 量 实体 变量 的 类 。 不 要 为 子 类 创建 大 
量 受 保护 变量 和 范 数 。 尽 力 保 持 接 口 紧 竣 。 通 过 限制 信息 来 控制 而 合 
度 。 

G9: 死 代码 

死 代码 就 是 不 执行 的 代码 。 可 以 在 检查 不 会 发 生 的 条 件 的 和 f 语 句 体 
中 找到 。 可 以 在 从 不 抛 出 异常 的 try 语 句 的 catch 块 中 找到 。 可 以 在 从 不 
被 调用 的 小 工具 方法 中 找到 ， 也 可 以 在 永 不 会 发 生 的 switch/case 条 件 中 
找到 © 

死 代码 的 问题 是 过 不 和 久 它 就 会 发 出 臭 味 。 时 间 越 入 ， 味 道 就 越 酸 
臭 。 这 是 因为 ， 在 设计 改变 时 ， 死 代码 不 会 随 之 更 新 。 它 还 能 通过 编 
译 ， 但 并 不 会 遵循 较 新 的 约定 或 规则 。 它 编写 的 时 候 ， 系 统 是 另 一 番 
模样 。 如 果 你 找到 死 代码 ， 就 体面 地 埋葬 它 ， 将 它 从 系统 中 删除 掉 。 

G10: BHA 
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其 首次 被 使 用 的 位 置 上 面 声明 ， 垂 直 距 离 要 短 。 本 地 变量 不 该 在 其 被 
使 用 之 处 几 百 行 以 外 声明 。 

私有 函数 应 该 刚好 在 其 首次 被 使 用 的 位 置 下 面 定 义 。 私 有 函数 属 
于 整个 类 ， 但 我 们 还 是 要 限制 调用 和 定义 之 间 的 垂直 距离 。 找 个 私有 
函数 ， 应 该 只 是 从 其 首次 被 使 用 处 往 下 看 一 点 那么 简单 。 

G11: 前 后 不 一 致 


从 一 而 终 。 这 可 以 追溯 到 最 小 慰 异 原则 。 小 心 选择 约定 ， 一旦 选 
中 ， 就 小 心 持续 遵循 。 

UN RE RE NA PH Z response 的 变量 来 持 有 
HttpServletResponse 对 象 ， 则 在 其 他 用 到 HttpServletResponse X: RAY ER 
数 中 也 用 同样 的 变量 名 。 如 有 果 将 某 个 方法 命名 为 
processVerificationRequest， 则 给 处 理 其 他 请 求 类 型 的 方法 取 类 似 的 名 
字 ， 例 如 processDeletion Request ° 

如 此 人 窗 单 的 前 后 一 致 ， 一 旦 坚决 贯彻 ， 残 能 让 代码 更 加 易于 阅读 
和 修改 。 

G12: 混淆 视听 

没有 实现 的 默认 构造 器 有 何 用 处 呢 ? 它 只 会 用 无 意义 的 杂碎 搞 乱 
对 代码 的 理解 。 没 有 用 到 的 变量 ， 从 不 调用 的 函数 ， 没 有 信息 量 的 注 
释 ， 等 等 ， 这 些 都 是 应 该 移 除 的 上 废物。 保持 产 文件 整洁 ， 民 好 地 组 
A, IBRA e 

G13: 人 为 耦合 

不 互相 依赖 的 东西 不 该 耦合 。 例 如 ， 普 通 的 enum 不 应 在 特殊 类 中 
包括 ， 因 为 这 样 一 来 应 用 程序 就 要 了 解 这 些 更 为 特殊 的 类 。 对 于 在 特 
殊 类 中 声明 一 般 目 的 的 static 函 数 也 是 如 此 。 

一 般 来 说 ， 人 为 耦合 是 指 两 个 没有 直接 目的 之 间 的 模块 的 耦合 。 
其 根源 是 将 变量 、 负 量 或 函数 不 恰当 地 放 在 临时 方便 的 位 置 。 这 是 种 
漫不经心 的 偷懒 行为 。 

化 点 时 间 人 研 究 应 该 在 什么 地 方 声明 函数 、 常 量 和 变量 。 不 要 为 了 
方便 随手 放置 ， 人 然后 置之不理 。 

G14: 特性 依恋 

这 是 Martin Fowler 提 出 的 代码 味道 之 一 [6]。 类 的 方法 只 应 对 其 所 
属 类 中 的 变量 和 函数 感 兴趣 ， 不 该 王 青 其 他 类 中 的 变量 和 函数 。 当 方 
法 通过 某 个 其 他 对 象 的 访问 器 和 修改 器 来 操作 该 对 象 内 部 数据 ， 则 它 
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直接 访问 它 操作 的 变量 。 例 如 : 
public class HourlyPayCalculator { 


public Money calculateWeeklyPay(HourlyEmployee e) 1 
int tenthRate = e.getTenthRate().getPennies(); 
int tenthsWorked = e.getTenthsWorked(); 
int straightTime = Math.min(400, tenthsWorked); 
int overTime = Math.max(0, tenthsWorked - straightTime); 
int straightPay - straightTime * tenthRate; 
int overtimePay - (int)Math.round(overTime*tenthRate*1.5); 


return new Money(straightPay + overtimePay); 


} 
方法 calculateWeeklyPay 伸手 到 HourlyEmployee X} A, IK ALLER 
TE BI EHR © 7j TZ calculateWeeklyPay fX 78 F HourlyEmployee H3 /F H Yè; 
° 它 “期 望 ” 目 己 在 HourlyEmployee 中 。 
同样 情况 下 ， 我 们 要 消除 特性 依恋 ， 因 为 它 将 一 个 类 的 — 
REAT AINAR 0 Pik, ERE RA D ERAS SUB 
面 的 代码 : 
public class HourlyEmployeeReport { 
private HourlyEmployee employee; 
public HourlyEmployeeReport(HourlyEmployee e) { 
this.employee = e; 
} 
String reportHours() { 
return String. format( 
"Name: %s\tHours:%d.%1d\n", 


employee.getName(), 
employee.getTenthsWorked()/10, 
employee.getTenthsWorked()%10); 


} 
显然 ，reportHours 方 法 依恋 于 HourlyEmployee 类 。 另 一 方面 ， 我 们 
并 不 想 要 HourlyEmployee 得 知 报告 的 格式 。 把 格式 化 字符 串 移 到 
HourlyEmployee 会 破坏 好 几 种 面 回 对 象 设 计 原 则 [Z]。 它 将 把 
HourlyEmployee 与 报告 的 格式 耘 合 起 来 ， 回 该 格式 的 修改 又 露 这 个 
R o 
G15: 选择 算 子 参数 
没有 什么 比 在 函数 调用 末尾 遇 到 一 个 false 参 数 更 为 可 民 的 事情 
了 。 那 个 false 是 什么 意思 ? 如 果 它 是 tue， 会 有 什么 变化 吗 ? 不 仅 是 一 
个 选择 算 子 (selector) 参数 的 目的 难以 记 住 ， 每 个 选择 算 子 参数 将 多 
个 函数 绑 到 了 一 起 。 选 择 算 子 参数 只 是 一 种 避免 把 大 图 数 切 分 为 多 个 
小 函数 的 偷懒 做 法 。 考 虑 下 面 这 段 代 码 : 
public int calculateWeeklyPay(boolean overtime) 1 
int tenthRate = getTenthRate(); 
int tenthsWorked = getTenthsWorked(); 
int straightTime = Math.min(400, tenthsWorked); 
int overTime = Math.max(0, tenthsWorked - straightTime); 
int straightPay = straightTime * tenthRate; 
double overtimeRate = overtime ? 1.5 : 1.0 * tenthRate; 
int overtimePay = (int)Math.round(overTime*overtimeRate); 


return straightPay + overtimePay; 


当 加 班 时 间 以 一 倍 半 计算 薪资 时 ， 用 true 调 用 这 个 函数 ，false 则 表 
示 和 直接 计算 。 每 次 用 到 这 个 函数 ， 你 都 得 记 住 calculateWeeklyPay(false) 
表示 什么 ， 这 已 经 足够 糟糕 了 。 但 这 种 函数 真正 的 坏处 在 于 作者 错过 
了 这 样 写 的 机 会 : 
public int straightPay() { 
return getTenthsWorked() * getTenthRate(); 
} 
public int overTimePay() { 
int overTimeTenths = Math.max(0, getTenthsWorked() - 400); 


int overTimePay = overTimeBonus(overTimeTenths); 


return straightPay() * overTimePay; 
} 
private int overTimeBonus(int overTimeTenths) { 
double bonus = 0.5 * getTenthRate() * overTimeTenths; 
return (int) Math.round(bonus); 
} 
当然 ， 选 择 算 子 不 一 定 是 boolean 类 型 。 可 能 是 枚 举 元 素 、 整 数 或 
任何 一 种 用 于 选择 玫 数 行为 的 参数 。 使 用 多 个 函数 ， 通 第 优 于 回 单 个 
图 数 传递 某 些 代码 来 选择 函数 行为 。 
G16: BEXRBUERA 
代码 要 尽 可 能 具有 表达 力 。 联 排 表 达 式 、 匈 牙 利 语 标 记 法 和 魔术 
数 都 遮蔽 了 作者 的 意图 。 例 如 ， 下 面 是 overTimePay 函 数 可 能 的 一 种 表 
HET: 
public int m_otCalc() { 
return iThsWkd * iThsRte + 
(int) Math.round(0.5 * iThsRte * 
Math.max(0, iThsWkd - 400) 


y 

} 

它 既 短小 义 紧 并 ,但 实际 上 不 可 捉摸 。 值 得 花 时 间 将 代码 的 意图 
呈现 给 读者 。 

G17: 位 置 错误 的 权 责 

软件 开发 者 做 出 的 最 重要 决定 之 一 就 是 在 哪里 放 代 码 。 例 如，PI 
常量 放 在 何 处 ? 是 该 在 Math 类 中 吗 ? 或 者 应 该 属于 Trigonometry 类 ? 还 
是 在 Circle 类 ? 

最 小 惊异 原则 在 这 里 起 作用 了 。 代 码 应 该 放 在 读者 日 然而 然 期 待 
它 所 在 的 地 方 。PI 常量 应 该 在 出 现在 声明 三 角 函 数 的 地 方 。 
OVERTIME_RATE 常 量 应 该 在 HourlyPayCalculator 类 中 声明 。 

有 了 时， 我 们 “聪明 ”地 知道 在 何 处 放置 功能 代码 。 我 们 会 放 在 目 己 
方便 而 读者 不 能 随 直 党 找到 的 地 方 。 例 如 ， 也 许 我 们 需要 打印 出 某 个 
雇员 的 总 工作 时 间 鸭 报表 。 我 们 可 以 在 打印 报表 的 代码 中 做 工作 时 间 
统计 ， 或 者 我 们 可 以 在 接受 工作 时 间 卡 的 代码 中 保留 一 份 工作 时 间 记 
K o 

做 这 个 决定 的 途径 之 一 是 看 函数 名 称 。 比 如 ， 报 表 模 块 有 个 名 为 
getTotalHours 的 函数 。 接 受 时 间 卡 的 模块 有 一 个 SaveTimeCard 函 数 。 顾 
名 思 义 ， 哪 个 名 称 上 暗示 了 函数 会 计算 总 时 间 呢 ? 答案 显而易见 。 

显然 ， 对 于 总 时 间 应 该 在 接受 时 间 卡 的 时 候 计 算 而 不 是 在 打印 报 
表 时 计算 ， 这 里 面 有 些 性 能 上 的 考量 。 没 问题 ， 但 函数 名 称 应 该 反映 
这 种 考虑 。 例 如， 应 该 在 时 间 卡 模块 中 有 个 
computeRunningTotalOfHoursEk%{ © 

G18: 不 恰当 的 静态 方法 

Math.max(double a, double) 是 个 恨 好 的 静态 方法 。 它 并 不 在 单个 实 
Ik EHIE; 的 确 ， 不 得 不 写 new Math( ).max(a,b) & È a.max(b) LA È 
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象 。 而 且 ， 我 们 也 没 机 会 用 到 Math.max 的 多 态 特 征 。 

不 过 ， 我 们 有 时 也 编写 不 该 是 静态 的 静态 方法 。 例 如 : 

HourlyPayCalculator.calculatePay(employee, overtimeRate). 

这 看 起 来 像 是 个 有 道理 的 static 函 数 。 它 并 不 在 任何 特定 对 象 上 操 
作 ， 而 且 从 参数 中 获得 全 部 数据 。 然 而 ， 我 们 却 有 理由 希望 这 个 函数 
是 多 仿 的 。 我 们 可 能 希望 为 计算 每 小 时 文 付 工资 实现 几 种 不 同 算法 ， 
例如 OvertimeHourlyPayCalculator 和 StraightTimeHourlyPayCalculator ° 
所 以 ， 在 这 种 情况 下 ， 该 函数 就 不 该 是 静态 的 。 它 该 是 Employee 的 非 

通 沼 应 该 倾向 于 选用 非 静 仿 方 法 。 如 果 有 疑问 ， 束 古 用 非 静 态 函 
数 。 如 果 的 确 需要 静态 函数 ， 确 保 没 机 会 打算 让 它 有 多 态 行为 。 

G19: 使 用 解释 性 变量 

Kent Beck 在 其 巨著 Smalltalk Best Practice Patterns[8 | 4 5 — € E # 
Implementation Patterns (中 译 版 《实现 模式 》) [9] 中 都 写 到 这 个 。 让 
程序 可 读 的 最 有 力 方 法 之 一 就 是 将 计算 过 程 打 散 成 在 用 有 意义 的 单词 
命名 的 变量 中 放置 的 中 间 值 。 

看 看 来 目 FitNesse 的 这 个 例子 : 

Matcher match = headerPattern.matcher(line); 

if(match.find()) 

{ 

String key = match.group(1); 


String value = match.group(2); 
headers.put(key.toLowerCase(), value); 
} 
RPE VES AICP AE, VINTE T VOC ZA key, mE 
个 匹配 组 是 value。 


这 事 很 难 做 过 火 。 解 释 性 变量 多 比 少 好 。 只 要 把 计算 过 程 打 散 成 
一 系列 民 好 命名 的 中 间 值 ， 不 透明 的 模块 束 会 突然 变 得 透明 ， 这 很 值 
得 注意 。 

G20: BRAMMAZRARTA 

看 看 这 行 代码 : 

Date newDate = date.add(5); 

你 会 期 望 它 同日 期 添加 5 天 吗 ? 或 者 是 5 个 星期 ? 5 个 小 时 ? 该 date 
实体 会 变化 吗 ? 或 者 该 函数 只 是 返回 一 个 新 的 Date 实 体 ， 并 不 改动 旧 
HJ? 从 函数 调用 中 看 不 出 函数 的 行为 。 

如 采 阔 数 同 日 期 添加 5 天 并 旦 修改 该 日 期 ， 就 该 命名 为 addDaysTo 
或 increaseByDays。 如 采 函 数 返 回 一 个 表示 5 天 后 的 日 期 ， 而 不 修改 日 
期 实体 ， 就 该 叫做 daysLater 或 daysSince 。 

如 果 你 必须 查看 函数 的 实现 (或 文档 ) AAD EE BUT ABI, DÌ 
该 换个 更 好 的 函数 名 ， 或 者 重新 安排 功能 代码 ， 放 到 有 较 好 名 称 的 画 
数 中 。 

G21: 理解 算法 

好 多 可 笑 代码 的 出 现 ， 是 因为 人 们 没 论 时 间 去 理解 算法 。 他 们 硬 
塞 进 足 够 多 的 计 语 句 和 标识 ， 从 不 真正 停 下 来 考虑 发 生 了 什么 ， 勉 强 让 
系统 能 工作 。 

编程 常常 是 一 种 探险 。 你 以 为 日 己 知道 菜 事 的 正确 算法 ， 然 后 就 
卷 起 袖子 睹 干 一 气 ， 搞 到 “可 以 工作 ”为 止 。 你 怎么 知道 它 “ 可 以 工作 ”? 
因为 它 通 过 了 你 能 想到 的 单元 测试 。 这 种 做 法 没 错 。 实 际 上 ， 这 也 是 
让 函数 按 你 设想 的 方式 执行 的 唯一 途径 。 不 过 ,“ 可 以 工作 ”周围 的 引 
号 可 不 能 一 直 保留 。 

在 你 认为 目 己 完成 某 个 函数 之 前 ， 确 认 目 己 理 解 了 它 是 怎么 工作 
的 。 通 过 全 部 测试 还 不 够 好 。 你 必须 知道 [10] 解 决 方案 是 正确 的 。 


获得 这 种 知识 和 理解 的 最 好 途径 ， 往 往 是 重 构 函 数 ， 得 到 某 种 整 
涪 而 足 具 表达 力 、 清 楚 至 示 如 何 工 作 的 东西 。 

G22: 把 逻辑 依赖 改 为 物理 依赖 

如 果 某 个 模块 依赖 于 男 一 个 模块 ， 依 赖 束 该 是 物理 上 的 而 不 是 多 
辑 上 的 。 依 赖 者 模块 不 应 对 被 依赖 者 模块 有 假定 (换言之 ， 逻 辑 依 
Ri) 。 它 应 当 明 确 地 询问 后 者 全 部 信息 。 

例如 ， 想 像 你 在 编写 一 个 打印 出 座 员 工作 时 长 的 纯 文本 报表 的 芳 
数 。 有 个 名 为 HourlyReporter 的 类 把 数据 收集 为 某 种 方便 的 形式 ,传递 
到 HourlyReportFormatter 中 ， 再 打印 出 来 。 (如 代码 清单 17-1 所 示 。) 

代码 清单 17-1 HourlyReporter.java 

public class HourlyReporter { 


private HourlyReportFormatter formatter; 
private List<Lineltem> page; 
private final int PAGE. SIZE = 55; 
public HourlyReporter(HourlyReportFormatter formatter) { 
this.formatter — formatter; 
page = new ArrayList<Lineltem>(); 
} 
public void generateReport(List<HourlyEmployee> employees) { 
for (HourlyEmployee e : employees) { 
addLineItemToPage(e); 
if (page.size() -- PAGE SIZE) 
printAndClearItemL ist(); 
} 
if (page.size() > 0) 
printAndClearItemList(); 


private void printAndClearItemList() 1 
formatter.format(page); 
page.clear(); 

} 

private void addLineItemToPage(HourlyEmployee e) { 
Lineltem item = new Lineltem(); 
item.name = e.getName(); 
item.hours = e.getTenthsWorked() / 10; 
item.tenths = e.getTenthsWorked() % 10; 
page.add(item); 

} 

public class LineItem 1 
public String name; 
public int hours; 


public int tenths; 


} 

这 段 代 码 有 尚未 物理 化 的 逻辑 依赖 。 你 能 指出 来 吗 ? Abie i i 
PAGE_SIZE。HourlyReporter 为 什么 要 知道 页 面 尺寸 ? 页 面 尺 寸 只 该 是 
HourlyReportFormatter 的 权 责 。 

PAGE SIZE 在 HourlyReporter 中 声明 ， 代 表 了 一 种 位 置 错误 的 权 贡 
[G17]， 导 致 HourlyReporter 假定 它 知道 页 面 尺 寸 。 这 类 假设 是 一 种 逻 
辑 依 顿 。HourlyReporter 依赖 于 HourlyReportFormatter 能 应 付 55 的 页 面 
尺寸 。 如 果 HourlyReportFormatter 的 某 些 实现 不 能 处 理 这 样 的 尺寸 ， 就 
会 出 错 。 

可 以 通过 创建 HourlyReport 中 名 为 getMaxPageSize( ) 的 新 方法 来 物 
理化 这 种 依赖 。HourlyReporter 将 调用 这 个 方法 ， 而 不 是 使 用 


PAGE SIZE' Œ ° 

G23: HZ SERI ElsesxkSwitch/Case 

有 了 第 6 章 谈 及 的 主题 ， 这 条 建议 看 似 奇怪 。 在 那 章 中 ， 我 提出 在 
添加 新 函数 甚 于 添加 新 类 型 的 系统 中 ，switch 语 句 是 恰当 的 。 

首先 ， 多 数 人 使 用 switch 语 句 ， 因 为 它 是 最 直截了当 又 有 力 的 方 
案 ， 而 不 是 因为 它 适合 当前 情形 。 这 给 我 们 的 启发 是 在 使 用 switch 之 
前 ， 先 考虑 使 用 多 态 。 

其 次 ， 画 数 变 化 其 于 类 型 变化 的 情形 相对 罕见 。 每 个 switch 语 句 都 
值得 怀疑 。 

我 使 用 所 谓 “ 单 个 switch”* 规 则 ， 对 于 给 定 的 选择 类 型 ， 不 应 有 多 于 
一 个 switch 语 句 。 在 那个 switch 语 句 中 的 多 个 case ， 必 须 创 建 多 态 对 
象 ， 取 代 系 统 中 其 他 类 似 switch 语 句 。 

G24: 遵循 标准 约定 

每 个 团队 都 应 遵循 基于 通用 行业 规范 的 一 套 编 码 标准 。 编 码 标准 
应 指定 诸如 在 何 处 声明 实体 变量 ， 如 何 命 名 类 ， 方 法 和 变量 ， 在 何 处 
放置 括号 ， 等 等 。 团 队 不 应 用 文档 描述 这 些 约定 ， 因 为 代码 本 身 提供 
了 范例 。 

团队 中 的 每 个 成 员 都 应 遵循 这 些 约定 。 这 意味 着 每 个 团队 成 员 必 
须 成 熟 到 能 了 解 只 要 全 体 同 意 在 何 处 放置 括号 ， 那 么 在 哪里 放置 都 无 
关 紧 要 。 

如 果 你 想 知道 我 遵循 哪些 约定 ， 可 以 查看 代码 清单 B-7~B-14 中 重 
构 之 后 的 代码 。 

G25: 用 命名 常量 替代 魔术 数 

这 大 概 是 软件 开发 中 最 古老 的 规则 之 一 了 。 我 记得 ， 在 20 世 纪 60 
年 代 介 绍 COBOL、FORTRAN 和 PL/1 的 手册 中 就 读 到 过 。 在 代码 中 出 
现 原始 形态 数字 通常 来 说 是 坏 现象 。 应 该 用 良好 命名 的 常量 来 隐藏 
它 o 


例如 ， 数 字 86400 应 当 藏 在 常量 SECONDS_PER_DAY 后 面 。 如 果 
每 页 打印 55 行 ， 则 常数 55 应 该 藏 在 常量 LINES_PER_PAGE 后 面 。 

有 些 常量 与 非常 具有 目 我 解释 能 力 的 代码 协同 工作 时 ， 如 此 易于 
识别 ， 也 就 不 必 总 是 需要 命名 常量 来 隐藏 了 。 例 如 : 

double milesWalked = feetWalked/5280.0; 

int dailyPay = hourlyRate * 8; 


double circumference - radius * Math.PI * 2; 

ft Lb f rm, d fj] SB vm E # KE FEET PER MILE ^ 
WORK, HOURS PER. DAYZITWOIBS'? 显然 ， 最 后 那个 很 可 笑 。 有 些 
情况 下 ， 篆 量 直 接 写 作 原 始 形态 数字 会 更 好 。 你 可 能 会 质疑 
WORK_HOURS_PER_DAY， 因 为 约定 规则 可 能 会 改变 。 男 一 方面 ， 在 
这 里 直接 用 数字 8 读 起 来 很 舒服 ， 也 束 没 必要 非 用 17 个 额外 的 字母 来 加 
重读 者 负担 不 可 。 对 于 FEET_PER_MILE， 数 字 5280 众 人 皆 知 ， 意 义 独 
特 ， 即 便 没 有 上 下 文 环境 ， 读 者 也 能 识别 它 。 

3.141592653589793 之 类 常数 也 从 所 周知， 很 容易 识别 。 不 过 ， 如 
果 直 接 使 用 原始 形式 ， 却 很 有 可 能 出 销 。 每 次 有 人 看 到 
3.141592653589793， 都 会 知道 那 是 值 ， 从 而 不 会 去 仔细 查看 。 (你 发 
现 那 个 错误 的 数字 了 吗 ? ) 我 们 不 想 要 人 们 使 用 3.14、3.14159 或 3.142 
等 。 所 以 ， 为 我 们 定义 好 Math.PI 是 件 好 事 。 

术语 “魔术 数 " 不 仅 是 说 数字 。 它 泛 指 任何 不 能 上 自我 描述 的 符号 。 
例如 : 

assertEquals(7777, Employee.find("John Doe").employeeNumber()); 

上 列 断 言 中 有 两 个 魔术 数 。 第 一 个 显然 是 777， 它 的 意义 并 不 明 
确 。 第 二 个 魔术 数 是 John Doe， 因 为 其 意图 不 明显 。 

John Doe 是 开发 团队 创建 的 测试 数据 中 编号 为 #7777 的 座 员 。 团 队 
中 每 个 成 员 都 知道 ， 当 连接 到 数据 库 时 ， 里 面 已 经 有 数 个 雇员 信息 ， 
其 值 和 属性 都 是 大 家 熟知 的 。 所 以 ， 这 个 测试 应 该 读 作 : 


assertEquals( 

HOURLY EMPLOYEE ID, 

Employee.find(HOURLY EMPLOYEE NAME).employeeNumber( 
)); 
G26: 准确 
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数 表示 货币 几 近 于 犯罪 。 因 为 你 不 想 做 并 发 更 新 就 避免 使 用 锁 和 /或 事 
务 管 理 往 好 处 说 也 是 一 种 懒 情 行 为 。 在 可 以 用 List 的 时 候 非 要 把 变量 声 
明 为 ArrayList 束 过 分 拘束 了 。 把 所 有 变量 设置 为 protected 却 不 够 自律 。 

在 代码 中 做 决定 时 ， 确 认 自 己 足 够 准确 。 明 确 自己 为 何 要 这 人 么 
做 ， 如 果 人 过 到 异常 情况 如 何 处 理 。 别 懒得 理会 决定 的 准确 性 。 如 果 你 
打算 调用 可 能 返回 null 的 函数 ， 确 认 自己 检查 了 null 值 。 如 果 查 询 你 认 
为 是 数据 库 中 唯一 的 记录 ， 确 保 代 码 检 查 不 存在 其 他 记录 。 如 果 要 处 
理 货币 数据 ， 使 用 整数 [11]， 并 恰当 地 处 理 四 人 铭 五 入 。 如 有 果 可 能 有 并 发 
更 新 ， 确 认 你 实现 了 某 种 锁定 机 制 。 

代码 中 的 舍 糊 和 不 准确 要 么 是 意见 不 同 的 结果 ， 要 么 源 于 懒 懈 。 
无 论 原因 是 什么 ， 都 要 消除 。 

G27: 结构 其 于 约定 

坚守 结构 其 于 约定 的 设计 决策 。 命 名 约定 很 好 ， 但 却 次 于 强制 性 
的 结构 。 例 如 ， 用 到 良好 命名 的 枚 举 的 switch/case 要 弱 于 拥有 抽象 方法 
的 基 类 。 没 人 会 被 强迫 每 次 都 以 同样 方式 实现 switchy/case 语 句 ， 但 基 类 
却 让 具体 类 必须 实现 所 有 抽象 方法 。 

G28: 封装 条 件 

如 果 没 有 if 或 while 语 句 的 上 下 文 ， 布尔 逻辑 束 难 以 理解 。 应 该 把 解 
释 了 条 件 意 图 的 函数 抽 离 出 来 。 

例如 : 

if (shouldBeDeleted(timer)) 


要 好 于 
if (timer.hasExpired() && !timer.isRecurrent()) 
G29: 避免 否定 性 条 件 
否定 式 要 比 肯 定式 难 明日 一 些 。 所 以 ， 尽 可 能 将 条 件 表示 为 肯定 
形式 。 例 如 : 
if (buffer.shouldCompact()) 
要 好 于 
if (!buffer.shouldNotCompact()) 
G30: 画 数 只 该 做 一 件 事 
编写 执行 一 系列 操作 的 包括 多 段 代 码 的 函数 前 常 是 诱 人 的 。 这 类 
函数 做 了 不 只 一 件 事 ， 应 该 转换 为 多 个 更 小 的 范 数 ， 每 个 只 做 一 件 
E o 
例如 : 
public void pay() { 
} 
for (Employee e : employees) { 
if (e.isPayday()) 1 
Money pay - e.calculatePay(); 
e.deliverPay(pay); 
} 
} 
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资 ， 然 后 支付 薪水 。 代 码 可 以 写 得 更 好 ， 如 : 
public void pay() 1 


for (Employee e : employees) 


payIfNecessary(e); 


private void payIfNecessary(Employee e) { 

if (e.isPayday()) 

calculateAndDeliverPay(e); 

} 
private void calculateAndDeliverPay(Employee e) { 

Money pay = e.calculatePay(); 

e.deliverPay(pay); 
} 
上 列 每 个 函数 都 只 做 一 件 事 。 ( 见 前 文 “只 做 一 件 事 ” 一 节 。) 
G31: 掩蔽 时 序 耦 合 
常 钊 有 必要 使 用 时 序 耘 合 ， 但 你 不 应 该 掩蔽 它 。 排 列 函 数 参数 ， 

好 让 它们 被 调用 的 次 序 显而易见 。 看 下 列 代码 : 

public class MoogDiver { 


Gradient gradient; 

List<Spline> splines; 

public void dive(String reason) { 
saturateGradient(); 
reticulateSplines(); 


diveForMoog(reason); 


} 

三 个 函数 的 次 序 很 重要 。 捕 鱼 之 前 先 织 网 ， 织 网 之 前 先 编 强 。 不 
夷 的 是 ， 代 码 并 没有 强制 这 种 时 序 厦 合 。 其 他 程序 员 可 以 在 调用 
saturateGradient 之 前 调 用 reticulateSplines , M m & & 35 d 
UnsaturatedGradientException 异 常 。 更 好 的 方式 是 : 

public class MoogDiver { 


Gradient gradient; 

List<Spline> splines; 

public void dive(String reason) { 
Gradient gradient = saturateGradient(); 
List<Spline> splines = reticulateSplines(gradient); 


diveForMoog(splines, reason); 


Ft ale EPA FARE T RR o ECS EN SAB EF 
一 个 函数 所 需 的 结果 ， 这 样 一 来 就 没 理由 不 按 顺 序 调用 了 。 
你 可 能 会 抱怨 着 增加 了 函数 的 复杂 度 ， 没 错 ， 不 过 这 点 额外 的 复 
杂 度 却 曝露 了 该 种 情况 真正 的 时 序 复杂 性 
注意 我 保留 了 那些 实体 变量 。 我 假设 类 中 的 私有 方法 可 能 会 用 到 
它们 。 即 便 如 此 ， 我 还 是 希望 参数 能 让 时 序 耦 合 变 得 可 见 
G32: 别 随意 
构建 代码 需要 理由 ， 而 且 理 由 应 与 代码 结构 相 契 合 。 如 果 结 构 显 
得 太 随 意 ， 其 他 人 就 会 想 修改 它 。 如 有 果 结 构 自 始 至 终 保 持 一 怪 ， 其 他 
人 束 会 使 用 它 ， 并 且 遵 循 其 约定 。 例 如 ， 我 最 近 对 FitNesse 做 合并 修 
改 ， 发 现 有 位 页 献 者 这 么 做 : 
public class AliasLinkWidget extends ParentWidget 
{ 
} 
public static class VariableExpandingWidgetRoot { 


问题 在 于 ，VariableExpandingWidgetRoot 没 必要 在 AliasLinkWidget 
作用 范围 之 内 。 而 且 ， 其 他 无 关 的 类 也 用 到 
AliasLinkWidget.VariableExpandingWidgetRoot ° 这 些 类 没 必 要 了 解 
AliasLinkWidget ° 

或 许 那 位 程序 员 只 是 循 例 把 VariableExpandingWidgetRoot 放 到 
AliasWidget 里 面 ， 或 者 他 真 认为 这 么 做 是 对 的 。 不 管 原因 是 什么 ， 结 
有 末 都 显得 随心 所 和 欲 。 不 作为 类 工具 的 公共 类 ， 不 应 该 放 到 其 他 类 里 
面 。 惯 例 是 将 它 置 为 public， 并 且 放 在 代码 包 的 顶部 。 

G33: 封装 边界 条 件 

边 弄 条 件 难以 奶 踩 。 把 处 理 边 弄 条 件 的 代码 集中 到 一 处 ， 不 要 散 
落 于 代码 中 。 我 们 不 想见 到 四 处 散 见 的 +1 和 一 1 字样 。 看 看 这 个 来 目 
FIT 的 向 单 例子 : 

if(level + 1 < tags.length) 

{ 

parts = new Parse(body, tags, level + 1, offset + endTag); 


body = null; 
} 
TERS, level + 1 出 现 了 两 次 。 这 是 个 应 该 封装 到 名 为 nextLevel 之 类 
的 变量 中 的 边界 条 件 。 


int nextLevel = level + 1; 


if(nextLevel « tags.length) 

{ 

} 
parts = new Parse(body, tags, nextLevel, offset + endTag); 
body = null; 

G34: 画 数 应 该 只 在 一 个 抽象 层级 上 
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操作 的 下 一 层 。 这 可 能 是 最 难 理解 和 遵循 的 启发 。 尽 管 概念 足够 直 
折 ， 人 们 还 是 很 容易 混 请 抽象 层级 。 例 如 ， 请 看 下 面 来 自 FitNesse 的 例 
EE 

public String render() throws Exception 

{ 

} 

StringBuffer html = new StringBuffer("<hr"); 
if(size > 0) 
html.append(" size=\"").append(size + 1).append(" V); 
html.append(">"); 
return html.toString(); 

稍微 研究 一 下 ， 你 就 会 看 到 发 生 了 什么 。 该 函数 构建 了 绘制 横贯 
页 面 线条 的 HTML 标 记 。 线 条 高 度 在 size 变 量 中 指定 。 

再 看 一 裔 。 方 法 混 洒 了 至 少 两 个 抽象 层级 。 第 一 个 是 横 线 有 尺寸 
这 个 概念 。 第 二 个 是 hr 标记 自 映 的 语法 。 这 段 代 码 来 自 FitrNesse 的 
HruleWidget 模 块 。 该 模块 检测 一 行 4 个 或 更 多 个 破 折 号 ， 并 将 其 转换 为 
恰当 的 hr 标记 。 破 折 号 越 多 ， 尺 寸 越 大 。 

我 重 构 了 这 段 代 码 。 注 意 ， 我 修改 了 size 字 段 的 名 称 ， 反 映 其 真正 
目的 。 它 表示 额外 破 折 号 的 数量 。 

public String render() throws Exception 

{ 

} 

HtmlTag hr = new HtmlTag("hr"); 
if (extraDashes > 0) 
hr.addAttribute("size", hrSize(extraDashes)); 


return hr.html(); 


private String hrSize(int height) 
{ 
} 
int hrSize = height + 1; 
return String.format("%d", hrSize); 
这 次 修改 很 好 地 拆 开 了 两 个 抽象 层级 。 函 数 render 只 构造 一 个 hr 标 
记 ， 不 去 管 该 标记 的 HIML 语 法 。 而 HtmlTag 模 块 则 照管 所 有 这 些 脐 脏 
的 语法 问题 。 
做 出 修改 时 ， 我 发 现 了 一 处 微小 的 错误 。 原 始 代 码 没有 加 上 hr 标 
记 的 结束 斜 线 符 ， 而 XHTML 标准 要 求 这 样 做 。 (换言之 ， 代 码 使 用 了 
<hr> 而 不 是 <hr />。) HtmlTag 模 块 很 早 就 改造 成 符合 XHTML 标准 了 。 
拆 分 不 同 抽象 层级 是 重 构 的 最 重要 功能 之 一 ， 也 是 最 难 做 的 一 
个 。 以 下 面 的 代码 为 例 。 这 是 我 第 一 次 符 试 拆 分 
HruleWidget.rendermethod 中 的 抽象 层级 的 结果 。 
public String render() throws Exception 
{ 
HtmlTag hr = new HtmlTag("hr"); 
if (size > 0) 1 
hr.addAttribute(" size", ""+(size+1)); 
} 
return hr.html(); 
} 
此 时 ， 我 的 目的 是 做 必要 的 拆 分 ， 并 让 测试 通过 。 我 轻易 达到 了 
这 一 目的 ， 但 结果 是 该 男 数 仍然 混杂 了 多 个 抽象 层级 。 此 时 ， 混 灯 的 
层级 是 hr 标记 的 构建 ， 以 及 size 变 量 的 翻译 和 格式 化 。 这 说 明 当 你 俑 抽 
象 界线 拆 解 男 数 时 ， 经 常会 按 出 原本 被 之 前 的 结构 所 掩蔽 的 新 抽象 界 
线 。 


G35: 在 较 高 层级 放置 可 配置 数据 
如 果 你 有 个 已 知 并 该 在 较 高 抽象 层级 的 默认 常量 或 配置 值 ， 不 要 
将 它 埋藏 到 较 低 层级 的 函数 中 。 把 它 作为 较 高 层级 函数 调用 较 低 层级 
函数 时 的 一 个 参数 。 看 看 以 下 来 目 FItNesse 的 代码 : 
public static void main(String[] args) throws Exception 
{ 


Arguments arguments = parseCommandLine(args); 


} 
public class Arguments 
{ 
public static final String DEFAULT PATH = "."; 
public static final String DEFAULT. ROOT = "FitNesseRoot"; 
public static final int DEFAULT. PORT = 80; 
public static final int DEFAULT VERSION DAYS - 14; 


} 

命令 行 参数 在 FitNesse 中 的 第 一 行 可 执行 代码 得 到 解析 。 这 些 参数 
的 默认 值 在 Argument 类 的 顶部 指定 。 你 不 必 到 系统 的 较 低 层级 去 得 看 
类 似 的 语句 : 

if (arguments.port == 0) // use 80 by default 

位 于 较 高 层级 的 配置 性 常量 易于 修改 。 它 们 向 下 贯穿 应 用 程序 。 
应 用 程序 的 较 低层 级 并 不 拥有 这 些 和 常量 的 值 。 

G36: 避免 传递 浏览 

通常 我 们 不 想 让 某 个 模块 了 解 太 多 其 协作 者 的 信息 。 更 具体 地 
说 ， 如 采 A 与 B 协 作 ，B 与 C 协作 ， 我 们 不 想 让 使 用 A 的 模块 了 解 CHI 


信息 。 (例如 ， 我 们 不 想 写 类 似 a.getB( ).getC( ).doSomething( ) I tt 
码 。) 

IX Wize Aris 1 as ol Et ° The Pragmatic Programmers (中 译 版 《 程 
序 员 修炼 之 道 》) 称 之 为 “编写 害羞 代码 *[12]。 两 者 都 归结 为 确保 模块 
只 了 解 其 直接 协作 者 ， 不 了 解 整 个 系统 的 游 哎 图 。 

如 果 有 多 个 模块 使 用 类 似 a.getB( ).getC( ) 这 样 的 语句 形式 ， 就 难以 
修改 设计 和 架构 ， 在 B 和 C 之 间 插 进 一 个 Q。 你 得 找到 a.getB( ).getC( ) tH 
现 的 所 有 地 方 ， 并 将 其 改 为 a.getB( ).getQ( ).getC( )。 系 统 就 此 变 得 缺乏 
柔 蔬 性 。 太 多 的 模块 了 解 了 太 多 有 关 架 构 的 信息 。 

正确 的 做 法 是 让 直接 协作 者 提供 所 需 的 全 部 服务 。 不 必 和 逛 志 系统 
的 对 象 全 图 ， 搜 寻 我 们 要 调用 的 方法 。 只 要 简单 地 说 : 


myCollaborator.doSomething(). 


17.5 Java 


Ji: 通过 使 用 通配符 避免 过 长 的 导入 清单 

如 果 使 用 了 来 自 同 一 程序 包 的 两 个 或 多 个 类 ， 用 以 下 语句 导入 整 
个 包 : 

import package.*; 

过 长 的 寻 入 清单 令 读者 望而却步 。 我 们 不 想 用 80 行 导入 语句 搞 乱 
模块 顶部 位 置 。 我 们 想 要 导入 语句 简约 地 列 出 我 们 要 使 用 的 包 。 

指定 导入 包 是 种 人 硬 依赖 ， 而 通配符 导入 则 不 是 。 如 有 果 你 具体 指定 
寻 入 某 个 类 ， 该 类 必须 存在 。 但 如 果 你 用 通配符 导入 某 个 包 ， 则 不 需 
要 存在 具体 的 类 。 导 入 语句 只 是 在 搜寻 名 称 时 把 这 个 包 列 入 查找 路 
径 。 所 以 ， 这 种 导入 并 未 构成 真正 的 依赖 ， 也 束 让 我 们 的 模块 较 少 


合 。 
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下 来 的 代码 ， 想 要 找 出 需要 为 哪些 类 构造 奉 号 类 和 占 位 代码 ， 就 可 以 
多 有 历 导 入 清单， 找 出 这 些 类 的 真名 ， 绸 恰当 地 放置 占 位 代码 。 不 过 ， 
这 种 用 法 很 罕见 。 而 且 ， 多 数 现代 IDE 人 允许 你 用 一 个 命令 就 把 通配符 导 
入 语句 转换 为 指定 导入 清单 。 所 以 ， 即 便 在 处 理 遗 留 代码 时 ， 最 好 也 
用 通配符 导入 。 

通配符 导入 有 了 时 会 导致 名 称 冲 突 和 歧义 。 两 个 同名 但 位 于 不 同 包 
中 的 类 需要 指名 导入 ， 或 至 少 在 使 用 时 指定 名 称 。 这 种 情形 的 确 讨 
厌 ， 不 过 很 罕见 ， 所 以 使 用 通配符 导入 通 浓 仍 优 于 指定 名 称 导 入 。 

J2: 不 要 继承 常量 

我 见 过 这 种 情况 好 几 次 ， 它 总 是 让 我 面 露 苦笑 。 某 个 程序 在 接口 
中 放 了 些 和 常量 ， 再 通过 继承 结构 来 访问 这 些 常量 。 看 看 以 下 代码 : 

public class HourlyEmployee extends Employee { 


private int tenthsWorked; 
private double hourlyRate; 
public Money calculatePay() 1 

int straightTime = Math.min(tenthsWorked, 

TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 
hourlyRate * (tenthsWorked + OVERTIME RATE * overTime) 


} 
常量 TENTHS PER _ WEEK 和 OVERTIME RATE 来 自 何方 ? 它们 可 
能 来 自 Employee 类 。 来 看 看 : 


public abstract class Employee implements PayrollConstants 1 
public abstract boolean isPayday(); 
public abstract Money calculatePay(); 
public abstract void deliverPay(Money pay); 
} 
不 ， 不 在 那儿 。 不 过 在 哪儿 呢 ? 再 仔细 看 Employee 类 。 它 实现 了 
PayrollConstants 接 口 。 
public interface PayrollConstants { 
public static final int TENTHS_PER_WEEK = 400; 
public static final double OVERTIME RATE = 1.5; 
} 
真是 丑陋 不 堪 ! EAE TARR ZR RAY ee IN UBI 别 利 用 继承 
欺 驴 编 程 语言 的 作用 范围 规划。 应 该 用 静态 导入 。 


import static PayrollConstants.*; 


public class HourlyEmployee extends Employee { 
private int tenthsWorked; 
private double hourlyRate; 
public Money calculatePay() 1 
int straightTime = Math.min(tenthsWorked, 
TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 
hourlyRate * (tenthsWorked + OVERTIME RATE * overTime) 


); 


J3: 常量 vs. MB 

现在 enum 已 经 加 入 Java 语 言 (Java5) ， 放 心 用 吧 ! 别 再 用 那个 
public static final int 老 花招 。 那 样 做 int 的 意义 束 形 失 了 ， 而 用 enum 则 不 
然 ， 因 为 它们 隶属 于 有 名 称 的 枚 举 。 

而 且 ， 仔 细 人 研究 enum 的 语法 。 它 可 以 拥有 方法 和 字段 ， 从 而 成 为 
能 比 int 提 供 更 多 表达 力 和 灵活 性 的 强 有 力 工 具 。 看 看 以 下 发 薪 代 人 码 中 
的 不 同 做 法 : 

public class HourlyEmployee extends Employee 1 


private int tenthsWorked; 
HourlyPayGrade grade; 
public Money calculatePay() 1 

int straightTime = Math.min(tenthsWorked, 

TENTHS PER WEEK); 
int overTime - tenthsWorked - straightTime; 
return new Money( 
grade.rate() * (tenthsWorked + OVERTIME RATE * overTime) 


); 


j 
public enum HourlyPayGrade 1 


APPRENTICE { 
public double rate() 1 
return 1.0; 
} 


}, 
LEUTENANT_JOURNEYMAN { 


public double rate() 1 
return 1.2; 
} 
n 
JOURNEYMAN { 
public double rate() 1 


return 1.5; 
} 
}, 
MASTER { 
public double rate() { 
return 2.0; 
} 
is 
public abstract double rate(); 
} 
17.6 名 称 
: 采用 描述 性 名 称 


决 取 名 。 确 认 名 称 具 有 描述 性 。 记 住 ， i LA 
件 的 演化 而 变化 ， 所 以 ， 要 经 常 性 地 重新 信和 量 名 称 是 否 恰当 

这 不 仪 是 一 条 “感觉 民 好 式 ” 建 议 。 软 件 中 的 名 称 对 于 软件 可 读 性 
有 90% 的 作用 。 你 要 花 时 间 明智 地 取 各， 保持 名 称 有 关 。 名 称 太 重 要 
了 ， 不 可 随意 对 待 。 


看 看 以 下 代码 。 这 段 代码 是 做 什么 的 ? 用 了 好 名 称 的 代码 一 目 了 
然 ， 而 这 样 的 代码 却 是 符号 和 魔术 数 的 大 杂烩 。 
public int x() { 


int q = 0; 
int z = 0; 
for (int kk = 0; kk < 10; kk++) ( 
if (I[z] == 10) 
{ 
q+= 10+ (I[z + 1] * l[z + 2]); 
z+=1; 
} 
else if (I[z] + I[z + 1] == 10) 
{ 
q += 10+ I[z + 2]; 
z+=2; 
} else { 
q += I[z] + I[z + 1]; 
Z += 2; 
return q; 


} 


} 
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意思 写 出 遗漏 的 函数 。 魔 术 数 不 复 神秘 ， 算 法 的 结构 也 足 具 描 述 性 。 


public int score() { 


int score = 0; 


int frame = 0; 
for (int frameNumber = 0; frameNumber < 10; frameNumber++) { 
if (isStrike(frame)) { 
score += 10 + nextTwoBallsForStrike(frame); 
frame += 1; 
} else if (isSpare(frame)) { 
score += 10 + nextBallForSpare(frame); 
frame += 2; 
} else { 
score += twoBallsInFrame(frame); 


frame += 2; 


} 
return score; 
} 
仔细 取 好 的 名 称 的 威力 在 于 ， 它 用 接 述 性 信息 覆盖 了 代码 。 这 种 
信息 覆盖 设 定 了 读者 对 于 模块 中 其 他 函数 行为 的 期 待 。 看 看 上 面 的 代 
码 ， 你 殉 能 推断 出 isStrike( ) 的 实现 。 读 到 isStrick 方 法 时 ， 它 “ 深 合 你 
mare 


private boolean isStrike(int frame) { 


return rolls[frame] == 10; 
j 
N2: 名 称 应 与 抽象 层级 相符 
不 要 取 沟 通 实现 的 名 称 ; 取 反映 类 或 函数 抽象 层级 的 名 称 。 这 样 
做 不 容易 。 人 们 擅长 于 混 末 抽象 层级 。 每 次 浏览 代码 ， 你 总 会 发 现 有 
些 变量 的 名 称 层 级 太 低 。 你 应 当 趁机 为 之 改名 。 要 让 代码 可 读 ， 需 要 
持续 不 断 的 改进 。 看 看 下 面 的 Modem 接 口 : 


public interface Modem ( 
boolean dial(String phoneNumber); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 
String getConnectedPhoneNumber(); 
j 
粗 看 还 行 。 函 数 看 来 都 很 合适 ， 对 于 多 数 应 用 程序 来 说 是 这 样 。 
不 过 ， 想 想 看 某 个 应 用 中 有 些 调 制 解 调 器 并 不 用 拨号 连接 的 情形 。 有 
些 用 线 缆 直 连 “就 像 如 今 为 多 数 家 庭 提供 Internet 连 接 的 线 缆 解 调 器 ) 
的 情形 。 有 些 通过 向 USB 口 发 送 端口 信息 连接 。 显 然 ， 有 关 电 话 号 三 
的 信息 就 是 位 于 错误 的 抽象 层级 了 。 对 于 这 种 情形 ， 更 好 的 命名 策略 
可 能 是 : 


public interface Modem { 


boolean connect(String connectionLocator); 
boolean disconnect(); 
boolean send(char c); 
char recv(); 
String getConnectedLocator(); 
} 
现在 名 称 再 不 与 电话 和 号码 有 关系 。 还 是 可 以 用 于 用 电话 号 码 的 情 
形 ， 也 可 以 用 于 其 他 连接 策略 。 
N3: 尽 可 能 使 用 标准 命名 法 
如 果 名 称 基于 有 既 存 约定 或 用 法 ， 束 比较 易于 理解 。 例 如 ， 如 果 你 
采用 油 滩 工 模式 ， 束 该 在 给 油 只 类 命名 时 用 上 Decorator 字样 。 例 如 ， 
AutoHangupModemDecorator 可 能 是 某 个 给 Modem 类 刷 上 在 会 话 结束 时 
目 动 挂机 的 能 力 的 类 的 名 称 。 


模式 只 是 标准 的 一 种 。 例 如 ， 在 Java 中 ， 将 对 象 转换 为 字符 串 的 函 
数 通 币 命名 为 toString。 最 好 是 人 遵循 这 些 约定 ， 而 不 是 目 己 创造 命名 


法 。 


对 于 特定 项 目 ， 开 发 团队 第 党 发 明 上 自己 的 命名 标准 系统 。Eric 
Evans 称 之 为 项 目的 共同 语言 [14]。 代 码 应 该 使 用 来 目 这 种 语言 的 术 
语 。 简 言 之 ， 具 有 与 项 目 有 关 的 特定 蕊 义 的 名 称 用 得 越 多 ， 读 者 就 越 
容易 明日 你 的 代码 是 做 什么 的 。 

NA: 无 歧义 的 名 称 

选用 不 会 混 消 函数 或 变量 意义 的 名 称 。 看 看 来 目 FitNesse 的 这 个 例 
fi 

private String doRename() throws Exception 

{ 


if(refactorReferences) 


renameReferences(); 
renamePage(); 
pathToRename.removeNameFromEnd(); 
pathToRename.addNameToEnd(newName); 
return PathParser.render(pathToRename); 

} 

该 函数 的 名 称 含混 不 清 ， 没 有 说 明 函 数 的 作用 。 由 于 在 doRename 
函数 里 面 还 有 个 名 为 renamePage 的 函数 ， 这 就 更 不 明白 了 1! 这 些 名 称 
AA AR PN SERB AEN XE? 没有。 
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看 似 太 长 ， 的 确 也 很 长 ， 不 过 它 只 在 模块 中 的 一 处 被 调用 ， 所 以 其 解 
释 性 的 好 处 大 过 了 长 度 的 坏处 。 

N5: 为 较 大 作用 范围 选用 较 长 名 称 


名 称 的 长 度 应 与 作用 范围 的 广泛 度 相 关 。 对 于 较 小 的 作用 范围 ， 
可 以 用 很 短 的 名 称 ， 而 对 于 较 大 作用 艺 围 承 该 用 较 长 的 名 称 。 

类 似 i 和 j 之 类 的 变量 名 对 于 作用 施 围 在 5 行 之 内 的 情形 没 问 题 。 看 
看 以 下 来 目 老 “标准 保龄球 游戏 ?的 代码 族 段 : 

private void rollMany(int n, int pins) 

{ 

for (int i=0; i<n; i++) 
g.roll(pins); 

} 

这 段 代码 很 明白 ， 如 果 用 rollCount 之 类 烦人 的 名 称 代 替 变 量 1， 反 
而 是 徒 增 混乱 。 男 一 方面 ， 在 较 长 距离 上 ， 使 用 短 名 称 的 变量 和 函数 
会 料 失 其 含义 。 名 称 的 作用 范围 越 大 ， 名 称 束 该 越 长 、 越 准确 。 

N6: 避免 编码 

不 应 在 名 称 中 包括 类 型 或 作用 范围 信息 。 在 如 今 的 开发 环境 中 ， 
m_ 或 {之 类 前 级 完 全 无 用 。 类 似 vis。 (表示 图 形 系统 ) 之 类 的 项 目 或 子 
系统 名 称 也 属 多 余 。 当 今 的 开发 环境 不 用 纠缠 于 名 称 也 能 提供 这 些 信 
忆 。 不 要 用 匈牙利 语 命名 法 污染 你 的 名 称 。 

N7: 名 称 应 该 说 明 副 作用 

名 称 应 该 说 明 函 数 、 变 量 或 类 的 一 切 信息 。 不 要 用 名 称 掩蔽 副 作 
用 。 不 要 用 简单 的 动词 来 描述 做 了 不 止 一 个 简单 动作 的 函数 。 例 如 ， 
请 看 以 下 来 自 TestNG 的 代码 : 

public ObjectOutputStream getOos() throws IOException 1 


if (m oos == null) { 

m 00s = new ObjectOutputStream(m socket.getOutputStream()); 
} 
return m. oos; 


} 


该 函数 不 只 是 获取 一 个 oos, WR oos 不 存在 ， 还 会 创建 一 个 。 所 
以 ， 更 好 的 名 称 大 概 是 createOrReturnOos。 


17.7 测试 


T1: 测试 不 足 

一 套 测 试 中 应 该 有 多 少 个 测试 ? 不 幸 的 是 ， 许 多 程序 员 的 衡量 标 
准 是 “看 起 来 够 了 ”。 一 套 测试 应 该 测 到 所 有 可 能 失败 的 东西 。 只 要 还 
有 没 被 测试 探测 过 的 条 件 ， 或 是 还 有 没 被 验证 过 的 计算 ， 测 试 就 还 不 
够 。 

T2: 使 用 覆盖 率 工具 

窗 盖 率 工具 能 汇报 你 测试 策略 中 的 缺口 。 使 用 覆盖 率 工具 能 更 容 
易 地 找到 测试 不 足 的 模块 、 类 和 画 数 。 多 数 IDE 都 给 出 直观 的 指示 ， 用 
绿色 标记 测试 覆盖 了 的 代码 行 ， 而 未 履 盖 的 代码 行 则 是 红色 。 这 样 就 
能 又 快 又 容易 地 找到 尚未 检测 过 的 if 或 catch 语 句 。 

T3: 别 略 过 小 测试 

小 测试 易于 编写 ， 其 文档 上 的 价值 高 于 编写 成 本 。 

T4: 被 忽略 的 测试 就 是 对 不 确定 事物 的 疑问 

有 时 ， 我 们 会 因为 需求 不 明 而 不 能 确定 某 个 行为 细节 。 可 以 用 注 
释 掉 的 测试 或 者 用 @Ignore 标记 的 测试 来 表达 我 们 对 于 需求 的 疑问 。 使 
用 哪 种 方式 ， 取 决 于 该 不 确定 性 所 关 涉 代码 是 否 要 编译 。 

T5: 测试 边界 条 件 

特别 注意 测试 边界 条 件 。 算 法 的 中 间 部 分 正确 但 边界 判断 错误 的 
情形 很 常见 。 

T6: 全 面 测试 相近 的 缺陷 
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那个 函数 。 你 可 能 会 发 现 缺 陷 不 止 一 个 。 

T7: 测试 失败 的 模式 有 启发 性 

有 时 ， 你 可 以 通过 找到 测试 用 例 失 败 的 模式 来 诊断 问题 所 在 。 
也 是 尽 可 能 编写 足够 完整 的 测试 用 例 的 理由 之 一 。 NA 
按 合理 的 顺序 排列 ， 能 又 露出 模式 。 

简单 举例 ， 假 设 你 注意 到 所 有 长 于 5 个 字符 的 输入 都 会 导致 测试 失 
败 ， 或 者 回 函 数 的 第 二 个 参数 传 入 负数 都 会 导致 汕 斌 失败。 有时， 只 
要 看 看 测试 报告 的 红 绿 模 式 ， 融 足以 红 放 出 那 句 认 来 解决 方法 的 “ 啊 
哈 ! ?回头 看 看 第 16 章 “ 重 构 SerialDate” 中 的 有 趣 例子 吧 。 

T8: 测试 覆盖 率 的 模式 有 局 发 性 

得 看 被 或 未 被 已 通过 的 测试 执行 的 代码 ， 往 往 能 发 现 失败 的 测试 
为 何 失败 的 线索 。 

T9: 测试 应 该 快速 

慢 速 的 测试 是 不 会 被 运行 的 测试 。 时 间 一 紧 ， 较 慢 的 测试 就 会 被 
摘 掉 。 所 以 ， 竟 尽 所 能 让 测试 够 快 。 


17.8 小 结 


这 份 司 发 与 味道 的 清单 很 难说 已 完备 无 缺 。 我 不 能 确定 这 样 一 份 
清单 会 不 会 完备 无 息 。 但 或 许 完整 性 不 该 是 目标 ， 因 为 该 清单 确实 给 
出 了 一 套 价值 体系 。 

那 套 价 值 体系 才 该 是 目标 ， 也 是 本 书 的 主题 所 在 。 整 洁 代码 并 非 
遵循 一 套 规则 写 束 。 学 习 一 系列 启发 并 不 足以 让 你 成 为 软件 匠人 。 专 
业 性 和 技艺 来 日 于 驱动 规程 的 价值 观 。 
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附录 A 并 发 编程 I 


Brett L.Schuchert 
本 附录 扩充 了 “并 发 编程 ”一 章 的 内 容 ， 由 一 组 相互 独立 的 主题 组 
成 ， 你 可 以 按 随意 顺序 阅读 。 为 了 实现 这 样 的 阅读 方式 ， 节 与 和 之 间 
存在 一 些 重复 内 容 。 


A.1 Wm/ X 


RR MERE a AR SS as HEY ^ 服务器 在 一 个 套 接 字 上 
FLR H MATTER ^ FS Vie Re PRA a FF AC TR TK ^ 


A.1.1 服务 器 


下 面 是 服务 响应 用 程序 的 简化 版 本 代码 。 在 后 文 “ 客 户 端 /服务 器 非 
多 线程 版 本 ”一 站 中 有 完整 的 代码 。 
ServerSocket serverSocket = new ServerSocket(8009); 
while (keepProcessing) 1 
try 1 
Socket socket = serverSocket.accept(); 
process(socket); 


} catch (Exception e) 1 


handle(e); 
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DRAK °F EXEBESIBR AS as EP m3: 
private void connectSendReceive(int i) { 
try { 
Socket socket = new Socket("localhost", PORT); 
MessageUtils.sendMessage(socket, Integer.toString(i)); 
MessageUtils.getMessage(socket); 
socket.close(); 
} catch (Exception e) { 
e.printStackTrace(); 


} 
这 对 客户 端 /服务 器 程序 运行 得 如 何 呢 ? 怎样 才能 正式 地 描述 其 性 
fe? 下面 是 断言 其 性 能 “可 接受 ”的 测试 : 
@Test(timeout = 10000) 
public void shouldRunInUnder10Seconds() throws Exception { 
Thread[] threads = createThreads(); 
startAllThreadsw(threads); 
waitForAllThreadsToFinish(threads); 
} 
为 了 让 例子 够 简单 ， 设 置 过 程 被 忽略 了 〈 见 后 文 ClientText.java 部 
分 ) 。 测 试 断言 程序 应 该 在 10000 毫 秒 内 完成 。 
这 十 个 验证 系统 吞吐 量 的 典型 例 和 于。 系统 应 该 在 10 秒 钟 以 内 完成 
一 组 客户 端 请 求 。 只 要 服务 器 能 在 时 限 内 处 理 每 个 客户 端 请 求 ， 测 试 


BOB TD ° 

ALARM AAI EE? 缺少 了 某 些 事件 轮 询 机 制 ， 在 单个 线程 上 
也 没什么 可 让 代码 更 快 的 手段 。 使 用 多 线程 能 解决 问题 吗 ? 可 能 会 ， 
我 们 先 得 了 解 什么 地 方 耗费 时 间 。 下 面 是 两 种 可 能 : 

IO 一 一 使 用 套 搂 字 、 连接 到 数据 库 、 等 竺 虚拟 内 存 交 换 等 ; 

处 理 磊 一 一 数值 计算 、 正 则 表达 式 处 理 、 垃 圾 回收 等 。 

以 上 在 系统 中 都 会 部 分 存在 ， 但 对 于 特定 的 操作 ， 其 中 之 一 会 起 
主导 作用 。 如 果 代 码 运 行 速度 主要 与 处 理 器 有 关 ， 增 加 处 理 器 硬件 就 
能 提升 吞吐 量 ， 从 而 通过 测试 。 但 CPU 运算 周期 是 有 上 限 的 ， 因 此 ， 
只 是 增加 线程 的 话 并 不 会 提升 受 处 理 器 限制 的 代码 的 速度 。 

男 一 方面 ， 如 末 否 吐 量 与 WO 有 天 ， 则 并 发 编程 能 提升 运行 效率 。 
当 系 统 的 某 个 部 分 在 等 每 /JO， 男 一 部 分 束 可 以 利用 等 待 的 时 间 处 理 其 
他 事务 ， 从 而 更 有 效 地 利用 了 CPU 能 


A.1.2 添加 线程 代码 


假定 性 能 测试 失败 了 “。 如 何 才能 提高 吞吐 量 、 通 过 性 能 测试 呢 ? 
"lll RR 88 HJ process TIF GVOAK, PE T ZNEW BR SS s] ARS 
(只 需要 修改 processMessage) : 
void process(final Socket socket) { 


if (socket == null) 


return; 
Runnable clientHandler = new Runnable() 1 
public void run() 1 
try 1 
String message = MessageUtils.getMessage(socket); 


MessageUtils.sendMessage(socket, "Processed: " * message); 


closeIgnoringException(socket); 
} catch (Exception e) 1 
e.printStackTrace(); 
} 
} 
}; 
Thread clientConnection = new Thread(clientHandler); 
clientConnection.start(); 
} 
假设 修改 后 测试 通过 了 [1。 代 码 是 否 完 整 、 正 确 了 呢 ? 


A.1.3 观察 服务 器 端 


修改 了 的 服务 器 成 功 通 过 测试 ， 只 花费 了 一 秒 多 钟 时 间 。 不 驻 的 
是 ， 这 种 解决 手段 有 点 一 厢 情 愿 ， 而 且 导 致 了 新 问题 产生 。 

服务 器 应 该 创建 多 少 个 线程 ? 代码 没有 设置 上 限 ， 所 以 我 们 很 有 
可 能 达到 Java 虚拟 机 (SVM) 的 限制 。 对 于 许多 简单 系统 来 说 这 无 所 
请 。 但 如 果 系 统 要 支持 公众 网 络 上 的 众多 用 户 呢 ?如 果 有 太 多 用 户 同 
Ere, AIA N EETETR © 

不 过 和 完 把 性 能 问题 放 到 一 边 吧 。 这 种 手段 还 有 整洁 性 和 结构 上 的 
[RIS o HR AS as RH Ze P RUD DET 

套 接 字 连 接管 理 ; 

客户 端 处 理 ; 

线程 策略 ; 

服务 器 关闭 策 略 。 
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级 。 所 以 ， 即 便 process 函 数 这 么 短小 ， 还 是 需要 再 加 以 切 分 。 
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并 发 系统 整洁 ， 应 该 将 线程 管理 代码 约束 于 少数 几 处 控制 民 好 的 地 
方 。 而 且 ， 管理 线程 的 代码 只 应 该 做 管理 线程 的 事 。 为 什么 ? 即便 无 
需 同 时 考虑 其 他 非 多 线程 代码 ， 跟 踪 并 发 问题 都 已 经 足够 困难 了 。 

如 果 为 上 述 每 个 权 责 〈 包 括 线程 管理 权 责 在 内 ) 创建 单独 的 类 ， 
当 改 动 线程 管理 集 略 时 ， 束 会 对 整个 代码 产生 较 小 影响 ， 不 至 于 污染 
其 他 权 责 。 这 样 一 来 ， 也 能 在 不 担心 线程 问题 的 前 提 下 测试 所 有 其 他 
权 责 。 下 面 是 修改 过 的 版 本 : 

public void run() { 


while (keepProcessing) 1 
try 1 
ClientConnection clientConnection = 
connectionManager.awaitClient(); 
ClientRequestProcessor requestProcessor 
= new ClientRequestProcessor(clientConnection); 
clientScheduler.schedule(requestProcessor); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
connectionManager.shutdown(); 
} 
所 有 与 线程 相关 的 东西 都 放 到 了 clientScheduler 里 面 。 如 果 出 现 并 
发 问题 ， 只 要 看 这 个 地 方 吏 好 了 : 
public interface ClientScheduler { 
void schedule(ClientRequestProcessor requestProcessor); 


} 


并 发 策略 易于 实现 : 
public class ThreadPerRequestScheduler implements ClientScheduler { 


public void schedule(final ClientRequestProcessor requestProcessor) 


Runnable runnable 7 new Runnable() 1 
public void run() 1 
requestProcessor.process(); 
} 
}; 
Thread thread = new Thread(runnable); 
thread.start(); 


} 

把 所 有 线程 管理 隔离 到 一 个 位 置 ， 修 改 控制 线 程 的 方式 就 容易 多 
了 。 例 如 ， 移 植 到 Java 5 Executor 框 染 就 只 需要 编写 一 个 新 类 并 插 进 来 
即 可 (如 代码 清单 A-1 所 示 ) e 

代码 清单 A-1 ExecutorClientScheduler.java 


import java.util.concurrent.Executor; 


import java.util.concurrent.Executors; 
public class ExecutorClientScheduler implements ClientScheduler { 
Executor executor; 
public ExecutorClientScheduler(int availableThreads) 1 
executor = Executors.newFixedThreadPool(availableThreads); 


} 


public void schedule(final ClientRequestProcessor requestProcessor) 


Runnable runnable = new Runnable() { 


public void run() 1 
requestProcessor.process(); 
} 
h 


executor.execute(runnable); 


A.1.4 小 结 


本 例 介 绍 的 并 发 编程 ， 滨 示 了 一 种 提高 系统 吞吐 量 的 方法 ， 以 及 
一 种 通过 测试 框架 验证 否 吐 量 的 方法 。 将 全 部 并 发 代码 放 到 少数 类 
中 ， 是 应 用 单一 权 责 原则 的 范例 。 对 于 并 发 编程 ， 因 其 复杂 性 ， 这 一 
点 万 其 重要 ° 


A.2 执行 的 可 能 路 径 


复查 没有 循环 或 条 件 分 文 的 单行 Java 方 法 incrementValue: 
public class IdGenerator { 
int lastIdUsed; 


public int incrementValue() { 


return 7-7 lastIdUsed; 


} 


} 
名 略 整数 次 出 的 情形 ， 假 定 只 有 单个 线程 能 访问 IdGenerator 的 单个 
实体 。 这 种 情况 下 ， 只 有 一 种 执行 路 径 和 一 个 确定 的 结果 : 返回 值 等 


于 lastIdUsed 的 值 ， 两 者 都 比 调用 方法 前 大 1。 

如 果 使 用 两 个 线程 、 不 修改 方法 的 话 会 发 生 什 么 ?如果 每 个 线程 
都 调用 一 次 incrementValue， 可 能 得 到 什么 结果 呢 ? 有 多 少 种 可 能 执行 
路 径 ? 首先 来 看 结果 (假定 lastIdUsed 初 始 值 为 93) : 

线程 1 得 到 94， 线 程 2 得 到 95，lastIdUsed 为 95; 

线程 1 得 到 95， 线 程 2 得 到 94，lastIdUsed 为 95; 

线程 1 得 到 94， 线 程 2 得 到 94，lastIdUsed 为 94。 

最 后 一 个 结果 尽管 令 人 吃惊 ， 也 是 有 可 能 出 现 的 。 要 想 明 日 为 何 
可 能 出 现 这 些 结 果 ， 就 需要 理解 可 能 执行 路 径 的 数量 以 及 Java 虚 拟 机 是 
如 何 执行 这 些 路 径 的 。 


A.2.1 路 径 数量 


为 了 算出 可 能 执行 路 径 的 数量 ， 我 们 从 生成 的 字 方 码 开 始 人 研究 。 
那 行 Java 代码 (return++lastIdUsed;) 变 成 了 8 个 字 节 码 指令 。 两 个 线程 
有 可 能 交错 执行 这 8 个 指令 ， 就 像 庄家 在 洗 牌 时 交错 脾 张 一 样 [2]。 即 便 
每 只 手 上 只 有 8 张 牌 ， 洗 牌 得 到 的 结 采 数量 也 很 可 观 。 

对 于 指令 系列 中 有 N 个 指令 和 T 个 线程 、 没 有 循环 或 条 件 分 文 的 简 
单 情况 ， 总 的 可 能 执行 路 径 数量 等 于 


(vr) 


NY 


计算 可 能 执行 次 序 
以 下 摘自 鲍 勃 大 叔 给 Brett 的 一 封 电子 邮件 : 
WENA TOMI TARE, BIUHT*NTOPUR e EDUISED BST 
前 ， 会 有 在 T 个 线程 中 选择 其 一 的 环境 开关 。 因 而 每 条 路 径 都 能 以 一 个 


数字 字符 串 的 形式 来 表示 该 环境 开关 。 对 于 步骤 A、B 及 线程 1 和 2， 可 
能 有 6 条 可 能 路 径 : 1122、1212、1221、2112、2121 和 2211。 或 者 以 指 
SH 4 #7 ON A1B1A2B2 ` A1A2B1B2 ` A1A2B2B1 ` A2A1B1B2 ` 
A2A1B2B1 及 A2B2A1B1。 对 于 三 个 线程 ， 执 行 序列 就 是 112233、 
112323 > 113223 ^ 113232 > 112233 ^» 121233 ^» 121323 ^ 121332 > 
123132 ` 123123...... 

这 些 字符 串 的 特征 之 一 是 每 个 T 总 会 出 现 N 次 。 所 以 字符 串 111111 
是 无 效 的 ， 因 为 里 面 有 6 个 1， 而 2 和 3 则 未 出 现 过 。 

所 以 要 排列 组 合 N1、N2...... 直 至 NT。 这 其 实 就 是 N * TH NAT 
的 排列 ， 即 (N*T)!， 但 要 剔除 重复 的 情形 。 所 以 ， 巧 妙 之 处 束 在 于 计算 
重复 次 数 并 从 (N*T)! 中 剔除 掉 。 

对 于 两 步 指令 和 两 个 线程 ， 有 多 少 重复 呢 ? 每 个 四 位 数字 符 串 中 
都 有 两 个 1 和 两 个 2。 每 个 这 种 配对 都 可 以 在 不 影响 字符 串 意义 的 前 提 
下 调换 。 可 以 同时 调换 全 部 1 和 2， 也 可 以 都 不 调换 。 所 以 每 个 字符 串 
束 有 四 种 同 构 形 态 ， 即 存在 3 次 重复 。 所 以 四 分 之 三 的 路 径 是 重复 的 ; 
而 四 分 之 一 的 排列 则 不 重复 。4!*.25=6。 这 样 计算 看 来 可 行 。 

有 和 多少 重 复 呢 ?对 于 N=1 且 T=2 的 情形 ， 我 可 以 调换 1， 调 换 2， 或 
两 者 都 调换 。 对 于 N=2 且 T=3 的 情形 ， 我 可 以 调换 1、2、3，1 和 2，1 和 
3， 或 2 和 3。 调 换 只 是 N 的 排列 组 合 受 了 。 设 有 N 的 P 种 排列 组 合 。 排 列 
组 合 的 方式 总 共有 P**T 种 。 

所 以 可 能 的 同 构 形态 数量 为 NI**T。 路 径 的 数量 束 是 
(T*N)WV(NI**T)。 对 于 T=2 且 N=2 的 情况 ， 结 果 就 是 6 ( 即 24/4) ° 

对 于 N=2 且 T=3， 结 果 是 720/8=90 ° 

对 于 N=3 且 T=3， 结 果 是 91/6^3=1680 。 

对 于 一 行 Java 代 码 (等 同 于 8 行 字 节 码 ) 和 两 个 线程 的 简单 情况 ， 
可 能 执行 路 人 径 的 总 数量 就 是 12870。 如果]astIdUsed 的 类 型 为 long， 每 次 
读 / 写 操 作 都 变 成 了 两 次 操作 ， 而 可 能 的 次 序 高 达 2704156 种 。 


如 果 改 动 一 下 该 方法 会 怎样 ? 
public synchronized void incrementValue() { 
++lastIdUsed; 
} 
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A.2.2 深入 挖掘 


两 个 线程 都 调用 方法 一 次 (在 添加 synchronize 之 前 ) 、 得 到 同一 结 
果 数 字 的 惊异 结果 义 怎 样 呢 ?怎么 可 能 出 现 这 种 情况 ? 一 样 一 样 来 。 

什么 是 原子 操作 ? 可 以 把 原子 操作 定义 为 不 可 中 断 的 操作 。 例 
如 ， 在 下 列 代码 的 第 5 行 ，0 被 赋值 给 lastid， 就 是 一 个 原子 操作 。 因 为 
依据 Java 内 存 模型 ，32 位 值 的 赋值 操作 是 不 可 中 断 的 。 

01: public class Example { 

02: int lastId; 


04: public void resetId() { 
05: value - 0; 
06: } 


08: public int getNextId() { 

09: ++value; 

10: } 

11: 3 

如 果 把 lastId 的 类 型 从 int 改 为 long 会 怎样 ? 第 5 行 还 是 原子 操作 吗 ? 
如 果 不 考 虚 JVM 规 约 ， 则 有 可 能 根据 处 理 右 不 同 而 不 同 。 不 过 ， 根 据 


JVM 规 约 ，64 位 值 的 赋值 需要 两 次 32 位 赋值 。 这 意味 着 在 第 一 次 和 第 
二 次 32 位 赋值 之 间 ， 其 他 线程 可 能 插 进 来 ， 修 改 其 中 一 个 值 。 

第 9 行 的 前 递增 操作 符 ++ 又 怎样 呢 ? 前 递增 操作 符 可 以 被 中 断 ， 所 
以 它 不 是 原子 的 。 为 了 理解 这 点 ， 仔 细 复 查 一 下 这 些 方 法 的 字 节 码 
吧 o 

在 更 进一步 之 前 ， 有 三 个 重要 的 定义 : 
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传 入 方法 的 参数 ， 以 及 方法 中 定义 的 本 地 变量 。 这 是 定义 一 个 调用 堆 
栈 的 标准 技术 ， 现 代 编 程 语言 用 来 实现 基本 函数 /方法 调用 和 递归 调 
FA; 

本 地 变量 一 -方法 作用 范围 内 定义 的 每 个 变量 。 所 有 非 静 态 方法 
至 少 有 一 个 变量 this， 代 表 当 前 对 象 ， 即 接收 导致 方法 调用 的 (当前 线 
程 内 ) 大 多 数 最 新 消息 的 对 象 ; 

运算 对 象 栈 一 “Java 虚拟 机 中 的 许多 指令 都 有 参数 。 运 算 对 象 栈 是 
放置 参数 的 地 方 。 堆 栈 是 个 标准 的 后 入 先 出 (LIFO) 数据 结构 。 

下 面 是 restId( INF P, AI A-1B ZR ° 


表 A-l restId( ) 的 字 节 码 


HT 描述 操作 对 象 栈 
ALOAD 0 将 第 0 个 变量 放 到 操作 对 象 栈 中 。 什 么 是 第 0 个 变 this 


量 ? 就 是 this， 当 前 对 象 。 当 方法 被 调用 ， 消 息 接 
收 者 ，Example 的 一 个 实体 ， 被 推 到 为 方法 调用 创 
建 的 框架 的 本 地 变量 数组 中 。 这 总 是 放 进 每 个 实体 
方法 的 第 一 个 变量 


ICONST 0 将 常量 值 0 放 到 操作 对 象 栈 中 this, 0 


PUTFIELD lastld | 将 堆栈 中 的 第 一 个 值 CHI 0) 存储 到 引用 对 象 的 字 | «empty 
段 值 ， 距 堆栈 顶部 this 一 个 对 象 引 用 的 距离 


这 三 个 指令 确保 是 原子 的 ， 因 为 尽管 执行 它们 的 线程 可 能 在 其 中 
任何 一 个 指令 后 被 打 断 ， 但 PUTFIELD 指 令 (堆栈 顶部 的 常量 值 0O 和 顶 
端 之 下 的 this 引 用 及 其 字段 值 ) 的 信息 并 不 能 为 其 他 线程 所 触及 。 所 


以 ， 当 赋值 操作 发 生 时 ， 值 0 一 定 将 存储 到 字段 值 中 。 该 操作 是 原子 
的 。 操 作对 象 都 处 理 对 于 方法 而 言 是 本 地 的 信息 ， 故 在 多 个 线程 之 间 
并 无 冲突 。 

所 以 ， 如 果 这 三 个 指令 由 10 个 线程 执行 ， 就 会 有 
4.38679733629e+24 种 可 能 的 执行 次 序 。 不 过 ， 只 会 有 一 种 可 能 的 结 
果 ， 所 以 执行 次 序 不 同 无 关 紧要 。 对 于 本 例 中 的 long 常 量 ， 总 是 有 同一 
种 运算 结果 。 为 什么 ? 因为 10 个 线程 的 赋值 操作 都 是 针对 一 个 常量 
的 。 即 便 它 们 互相 和 干涉， 结果 也 是 一 样 。 

方法 getNextId 中 的 ++ 操 作 就 会 有 问题 了 。 假 定 lastId 在 方法 开始 时 
的 值 为 42. 下 面 是 新 方法 的 字 节 码 ， 如 表 A-2 所 示 。 


表 A-2 新 方法 的 字 节 人 码 
ES 描述 操作 对 象 栈 
ALOAD 0 |# this 装载 到 操作 对 象 栈 this 
DUP 复制 堆栈 顶部 内 容 。 在 对 象 栈 中 有 两 个 this 的 复 本 this, this 


GETFIELD 从 指向 堆栈 顶部 (this) 的 对 象 中 取得 字段 lastId 的 值 ，| this, 42 


lastId 并 存储 回 堆栈 中 


ICONST 1 将 整数 常量 1 推 入 堆栈 this, 42, 1 
IADD 对 堆栈 顶部 的 两 个 值 做 整数 加 操作 ， 将 结果 存储 回 堆 栈 | this, 43 
DUP XI 复制 值 43， 放 到 this 之 前 43, this, 43 
PUTFIELD 将 堆栈 顶部 的 值 43 放 到 当前 对 象 的 字段 值 中 ， 表 现 为 |43 

value 对 象 栈 中 的 下 一 个 值 this 

IRETURN 返回 堆栈 顶部 《而 且 只 是 顶部 ) 的 值 <empty> 


设想 第 一 个 线程 完成 了 前 三 个 操作 ， 直 到 执行 完 GETFIELD， 然 后 
被 打 断 。 第 二 个 线程 接手 并 完成 整个 方法 调用 ，lastId 的 值 递 增 1;， 得 到 
的 值 为 43。 第 一 个 线程 再 从 中 断 处 继续 执行 ;操作 对 象 栈 中 的 值 还 是 
42， 因 为 那 就 是 该 线程 执行 GETFIELD 时 的 lastId 值 。 线 程 给 lastId 加 1 
得 到 43 ， 存 储 这 个 结果 。 第 一 个 线程 也 得 到 了 值 43。 结 果 束 是 其 中 一 
个 递增 操作 丢失 了 ， 因 为 第 一 个 线程 在 被 第 二 个 线程 打 断 后 又 踏 入 了 
第 二 个 线程 中 。 

将 getNextId( ) 方 法 修改 为 同步 方法 束 能 修正 这 个 问题 。 


A.2.3 小 结 


理解 线程 之 间 如 何 互相 干涉 ， 并 不 一 定 要 精通 字 节 码 。 如 果 你 能 
看 明白 这 个 例子 ， 它 应 该 已 经 展示 了 多 个 线程 之 间 互 相干 涉 的 可 能 
性 ， 这 已 经 足够 了 。 

这 个 小 例子 说 明 ， 有 必要 尽量 理解 内 存 模型 ， 明 白 什 么 是 安全 
的 ， 什 么 是 不 安全 的 。 有 一 种 普遍 的 误解 ， 认 为 ++ (前 递增 或 后 递 
增 ) 操作 符 是 原子 的 ， 其 实 并 非 如 此 。 你 必须 知道 : 

什么 地 方 有 共享 对 象 / 值 ; 

哪些 代码 会 导致 并 发 读 / 写 问题 ; 

如 何 防止 这 种 并 发 问题 发 生 。 


A.3.1 Executor 框 架 


如 前 文 ExecutorClientScheduler.java 所 演示 的 那样 ，Java 5 中 引入 的 
Executor 框架 文 持 利用 线程 池 进 行 复 杂 的 执行 。 那 天 是 
java.util.concurrent 包 中 的 一 个 类 。 

如 果 在 创建 线程 时 没有 使 用 线程 池 或 目 行 编写 线程 池 ， 可 以 考虑 
使 用 Executor。 它 能 让 代码 更 整洁 ， 易 于 理解 ， 且 更 加 短小 。 

Executor 框架 将 把 线程 放 到 池 中 ， 目 动 调整 其 大 小 ， 并 在 必要 时 重 
建 线 程 。 它 还 文 持 future， 一 种 通用 的 并 发 编程 构造 。Executor 能 与 实 
现 了 Runnable 的 类 协同 工作 ， 也 能 与 实现 了 Callable 接 口 的 类 协同 工 
作 。Callback 看 来 丈 像 是 Runnable， 但 它 能 返回 一 个 结 末 ， 那 在 多 线程 
解决 方案 中 是 普遍 的 需求 。 


当代 码 需要 执行 多 个 相互 独立 的 操作 并 等 待 这 些 操作 结束 时 ， 
future FAF: 
public String processRequest(String message) throws Exception { 
Callable<String> makeExternalCall = new Callable<String>() 1 
public String call() throws Exception 1 
String result = ""; 
// make external request 
return result; 
} 
}; 
Future<String> result = executorService.submit(makeExternalCall); 
String partialResult = doSomeLocalProcessing(); 
return result.get() + partialResult; 


} 
在 本 例 中 ， 方 法 开始 执行 makeExternalCall 对 象 。 然 后 该 方法 继续 


其 他 操作 。 最 后 一 行 代码 调用 result.get( )， 在 future 代 码 执 行 完 成 前 ， 
这 个 操作 是 锁定 的 。 


A.3.2 非 锁 定 的 解 ; 


Javad 虚拟 机 利用 了 现代 处 理 絮 支持 可 徘 、 非 锁定 更 新 的 设计 优 
点 。 例 如 ， 考 虑 某 个 使 用 同步 (从 而 也 是 锁定 的 ) 来 提供 线程 安全 地 
更 新 一 个 值 的 类 : 
public class ObjectWithValue { 
private int value; 
public void synchronized incrementValue() { ++value; } 


public int getValue() 1 return value; j 


} 

Java5 有 一 系列 用 于 此 类 情况 的 新 类 ， 例 如 AtomicBoolean ^ 
AtomicInteger 和 AtomicReference 等 ;还 有 为 外 一 些 。 我 们 可 以 重 写 上 面 
的 代码 ， 使 用 非 锁 定 的 手段 ， 如 下 所 示 : 

public class ObjectWithValue { 

private AtomicInteger value = new AtomicInteger(0); 
public void incrementValue() 1 
value.incrementAndGet(); 
} 
public int getValue() { 
return value.get(); 
} 

} 

即便 使 用 了 对 象 而 非 直接 操作 ， 使 用 了 incrementAndGet( ) 这 样 的 
言 轧 发 送 方式 而 非 ++ 操 作 ， 这 个 类 的 性 能 还 是 几乎 总 能 胜 过 上 一 版 
本 。 在 某 些 情况 下 只 会 快 一 点 点 ， 但 较 慢 的 情形 却 几 乎 不 存在 。 

BARAI? 现代 处 理 妖 拥有 一 种 通常 称 为 比较 交换 (Compare 
and Swap，CAS) 的 操作 。 这 种 操作 类 似 于 数据 库 中 的 乐观 锁定 ， 而 其 
同步 版 本 则 类 似 于 保守 锁定 。 

天 键 字 synchronized 总 是 要 求 上 锁 ， 即 便 第 二 个 线程 并 不 更 新 同一 
值 时 也 如 此 。 尽 管 这 种 固有 锁 的 性 能 一 直 在 提升 ， 但 仍然 代价 昂 贯 。 

非 上 锁 的 版 本 假定 多 个 线程 通常 并 不 频繁 修改 同一 个 值 ， 导 致 回 
题 产 生 。 它 高 效 地 侦 测 这 种 情形 是 否 发 生 ， 并 不 断 尝 试 ， 直 至 更 新 成 
功 。 这 种 侦 测 行为 几乎 总 是 比 上 锁 来 得 划算 ， 在 争 用 激烈 的 情况 下 也 
是 如 此 。 

虚拟 机 如 何 实现 这 种 机 制 ? CAS 的 操作 是 原子 的 。 逻 辑 上 ，CAS 
操作 看 起 来 像 这 样 : 


int variableBeingSet; 
void simulateNonBlockingSet(int new Value) { 
int currentValue; 
do { 
currentValue = variableBeingSet 
} while(current Value l= compareAndSwap(currentValue, 
new Value)); 

j 

int synchronized compareAndSwap(int currentValue, int newValue) 1 

if(variableBeingSet == currentValue) { 
variableBeingSet = new Value; 
return current Value; 

} 

return variableBeingSet; 

} 

当 某 个 方法 试图 更 新 一 个 共享 变量 ，CAS 操 作 束 会 验证 要 赋值 的 
变量 是 否 保 有 上 一 次 的 已 知 值 。 如 果 是 ， 束 修改 变量 值 。 如 果 不 是 ， 
则 不 会 磁 变 量 ， 因 为 另 一 个 线程 正在 试图 更 新 变量 值 。 要 更 新 数据 的 
方法 (通过 CAS 操 作 ) 查看 是 否 修改 并 持续 尝试。 


A.3.3 非 线程 安全 类 


有 些 类 天 生 不 是 线程 安全 的 。 下 面 是 几 个 例子 : 
数据 库 连 接 
java.util FAN Aas 


Servlet 


注意 ， 有 些 群 集 类 拥有 一 些 线程 安全 的 方法 。 不 过 ， 涉 及 调用 多 
个 方法 的 操作 都 不 是 线程 安全 的 。 例 如 ， 如 果 因 为 HashTable 中 已 经 有 
某 物 而 不 打算 替换 它 ， 可 能 会 写 出 以 下 代码: 

if(!hashTable.containsKey(someKey)) 1 


hashTable.put(someKey, new SomeValue()); 
} 
单个 方法 是 线程 安全 的 。 不 过 ， 另 一 个 线程 却 可 能 在 containsKey 
和 put 调 用 之 间 塞 进 一 个 值 。 有 几 种 修正 这 个 问题 的 手段 。 
先 锁 定 HashTable， 确 定 其 他 使 用 者 都 做 了 基于 客户 问 的 锁定 : 


synchronized(map) { 


if(!map.conainsKey(key)) 
map.put(key,value); 
} 
用 其 对 象 包装 HashTable， 并 使 用 不 同 的 API 一 一 利用 ADAPTER 模 
式 做 基于 服务 端的 锁定 : 
public class WrappedHashtable<K, V> { 
private Map<K, V> map = new Hashtable<K, V>(); 
public synchronized void putIfAbsent(K key, V value) { 
if (map.containsKey(key)) 
map.put(key, value); 


} 

采用 线程 安全 的 群集 : 

ConcurrentHashMapc Integer, String» map = new 
ConcurrentHashMap<Integer, String>(); 

map.putIf Absent(key, value); 


在 java.util.concurrent 中 的 群集 都 有 putIfAbsent( ) 之 类 提供 这 种 操作 
的 方法 。 


A.4 HZ IA 可 能 破坏 


以 下 是 一 个 有 关 在 方法 间 引 入 依赖 的 小 例子 : 
public class IntegerIterator implements Iterator<Integer> 
private Integer nextValue = 0; 
public synchronized boolean hasNext() 1 
return nextValue « 100000; 
} 
public synchronized Integer next() { 
if (nextValue == 100000) 
throw new IteratorPastEndException(); 
return nextValue++; 
} 
public synchronized Integer getNextValue() { 


return nextValue; 


} 
下 面 是 使 用 Integerlterator 的 代码 : 
Integerlterator iterator = new IntegerIterator(); 
while(iterator.hasNext()) { 

int next Value = iterator.next(); 


// do something with nextValue 


如 果 只 有 一 个 线程 执行 这 段 代 码 ， 不 会 有 什么 问题 。 但 如 果 有 两 
个 线程 抱 着 每 个 线程 都 处 理 它 获得 的 值 、 但 列表 中 的 每 个 元 素 都 只 被 
处 理 一 次 的 意图 ， 党 试 共享 IntegerIterator 的 单个 实体 ， 会 发 生 什 么 事 ? 
多 数 时 候 什 么 也 不 会 发 生 ; 线程 开心 地 共享 着 列表 ， 处 理 从 和 迭代 器 获 
取 的 元 素 ， 在 送 代 器 完成 执行 时 停 下 。 然 而 ， 在 送 代 的 末尾 ， 两 个 线 
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问题 在 这 里 。 线 程 1 调 用 hasNext( ) 方 法 ， 该 方法 返回 true。 线 程 1 占 
先 ， 然 后 线程 2 也 调用 这 个 方法 ， 同 样 返回 true。 线 程 2 接 着 调用 next( 
)， 该 方法 如 期 返回 一 个 值 ， 但 副作用 是 之 后 再 调用 hasNext( ) 束 会 返回 
false。 线 程 1 继续 执行 ， 以 为 hasNext( ) 还 是 true， 然 后 调用 next( )。 即 便 
单个 方法 是 同步 时 ， 客 户 端 还 是 使 用 了 两 个 方法 。 

这 的 确 是 个 问题 ， 也 是 并 发 代码 中 此 类 问题 的 典型 例子 。 在 这 个 
特殊 例子 中 ， 问 题 尤 其 隐蔽 ， 因 为 只 有 在 迭代 需 最 后 一 次 迭代 时 发 生 
才 会 导致 错误 。 如 果 线 程 刚好 在 那个 点 中 断 ， 其 中 一 个 线程 丈 可 能 超 
出 迭代 噩 末尾。 这 类 销 误 往往 在 系统 部 署 之 后 很 人 人 才 发 生 ， 而 且 很 难 
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出 现 错误 时 ， 你 有 3 种 做 法 。 
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修改 客户 代码 解决 问题 : ZETA SAE ; 

修改 服务 端 代 码 解决 问题 ， 同 时 也 修改 了 客户 代码 : 基于 服务 端 
的 锁定 。 


A.4.1 容忍 错误 


有 时 ， 可 以 通过 一 些 设置 让 错误 不 会 导致 损害 。 例 如 ， 上 述 客 户 
代码 可 以 捕 提 并 清理 异常 。 坦 白地 说 ， 这 有 点 草草 从 事 ， 就 像 是 半夜 


重启 解决 内 存 汇 露 问题 一 样 。 
A.4.2 基于 客户 代码 的 锁定 


要 让 Integerlterator 在 多 线程 情况 下 正确 运行 ， 对 客户 代码 做 如 下 修 
改 : 
Integerlterator iterator = new IntegerIterator(); 
while (true) { 
int nextValue; 
synchronized (iterator) { 
if (!iterator.hasNext()) 
break; 
nextValue - iterator.next(); 
} 
doSometingWith(nextValue); 
} 
每 个 客户 端 都 通过 synchronized 天 键 字 引入 一 个 锁 。 这 种 重复 违反 
了 DRY 原 则 ， 但 如 果 代码 使 用 非 线程 安全 的 第 三 方 工具 ， 可 能 必须 这 
样 做 。 
这 种 策略 有 风险 ， 因 为 使 用 服务 端的 程序 员 都 得 记 住 在 使 用 前 上 
锁 、 用 过 后 解锁 。 许 多 (许多! ) 年 前 ， 我 遇 到 过 一 个 在 共享 资源 上 
应 用 基于 客户 代 人 三 锁定 的 系统 。 代 码 中 有 几 百 处 用 到 这 个 资源 的 地 
方 。 有 位 可 怜 的 程序 员 志 记 在 其 中 一 处 做 资源 锁定 。 
该 系统 是 个 多 终端 分 时 系统 ， 为 Local 705 卡车 司机 联盟 运行 会 计 
软件 。 计 算 机 放 在 距 Local 705 总 部 50 英 里 ( 约 84.65km) 以 北 的 一 间 锐 
有 高 于 地 面 的 地 板 、 环 境 可 控 的 机 房 中 。 总 部 有 几 十 位 数据 录入 员 ， 


往 终端 输入 记录 。 终 端 使 用 电话 专线 和 600bits 的 半 双 工 调制 解 调 器 连 
接 到 计算 机 。 (这 可 是 很 久 很 久 以 前 的 事 了 。) 

每 天 大 概 都 会 有 一 台 终 端 毫 无 理由 地 * 死 锁 ”。 和 死 锁 也 不 限定 在 某 
些 终端 或 特定 时 间 。 允 像 症 有 人 丘 仍 子 选 择 死 锁 的 时 机 和 终端 一 般 。 
有 时 ， 会 有 几 台 终端 死 响 。 有 时 ， 好 几 天 都 不 出 现 死 锁 情 况 。 

刚 开 始 ， 唯 一 的 解决 手段 束 古 重启 。 但 协同 起 来 很 不 便 。 我 们 得 
打 电 话 给 总 部 ， 让 大 家 都 完成 在 终端 上 的 工作 。 然 后 我 们 才能 关机 、 
重 局 。 如 果 有 人 在 做 要 花 上 一 两 个 小 时 才能 做 完 的 事 ， 被 锁定 的 终 站 
就 只 能 一 直 等 着 。 

经 过 几 个 星期 的 调试 ， 我 们 发 现 ， 原 因 在 于 一 个 指针 不 同步 的 环 
形 缓冲 区 计数 絮 。 该 缓 促 区 控制 向 终 剖 的 输出 。 指 时 值 说 明 缓 冲 区 厦 
空 的 ， 但 计数 絮 却 指出 缓冲 区 是 满 的 。 因 为 缓冲 区 是 空 的 ， 束 没什么 
可 显 示 ; 但 因为 缓冲 区 也 是 满 的 ， 也 就 无 法 向 其 中 加 入 可 在 屏幕 上 显 
示 的 内 容 。 

我 们 知道 了 终端 为 何 会 死 锁 ， 但 却 不 知道 为 什么 环形 缓冲 区 会 不 
同步 。 我 们 用 了 点 手段 发 现 问题 所 在 。 当 时 程序 能 够 读 取 计 算 机 的 前 
面板 开关 状态 (这 可 是 很 久 很 久 以 前 的 事 了 ) 。 我 们 写 了 个 陷阱 程 
序 ， 侦 测 这 些 开关 何 时 被 挨 动 ， 然 后 查找 既 空 又 满 的 环形 缓冲 区 。 如 
条 找到 ， 融 重 置 该 缓冲 区 为 空 。 马 拉 ! 锁定 的 终端 又 重新 开始 显示 
[fe 

这 样 ， 在 终端 锁定 时 就 不 必 重 局 系统 了 。 客 户 只 需要 打 电 话 告诉 
我 们 出 现 死 锁 ， 我 们 就 径直 走 到 机 房 ， 拨 动 一 下 开关 即 可 。 

当然 ， 有 了 时 他 们 会 在 周末 加 班 ， 但 是 我 们 可 不 加 班 。 所 以 我 们 又 
在 计划 列表 中 添加 了 一 个 函数 ， 每 分 钟 检 查 一 次 全 部 环形 缓冲 区 ， 重 
置 既 空 又 满 的 缓冲 区 。 在 客户 打 电 话 之 前 ， 显 示 就 已 经 恢复 正常 了 。 

在 发 现 问题 原因 之 前 ， 我 们 伦 了 好 儿 个 星期 查看 一 页 又 一 页 的 单 
片 机 汇编 语言 代码 。 我 们 已 经 完成 计算 ， 算 出 死 锁 的 频率 是 周期 性 


的 ， 而 且 其 中 有 一 处 未 受 保护 的 环形 缓冲 区 使 用 。 所 以 ， 剩 下 的 任务 
束 是 找 出 那个 错误 的 用 法 。 不 辛 这 是 多 年 以 前 的 事 ， 那 时 既 没 有 搜索 
工具 ， 也 没有 交叉 引用 或 任何 其 他 目 动 化 帮助 手段 。 我 们 只 能 细 碍 代 
HER o 

在 芝加哥 1971 年 的 寒冬 ， 我 学 到 了 重要 的 一 课 。 基 于 客户 代码 的 
锁定 实在 不 可 靠 。 


A.4.3 基于 服务 端的 锁定 


按照 以 下 方式 修改 IntegerIterator 也 能 消除 重复 : 
public class IntegerIteratorServerLocked 1 
private Integer nextValue = 0; 
public synchronized Integer getNextOrNull() 1 
if (nextValue « 100000) 
return nextValue--; 
else 


return null; 


j 
客户 代码 也 要 修改 : 
while (true) { 
Integer nextValue = iterator.getNextOrNull(); 
if (next == null) 
break; 


// do something with nextValue 


} 


在 这 种 情形 下 ， 我 们 实际 上 是 修改 了 类 的 API， 使 其 能 适应 多 线程 
[3]。 客户 端 需要 做 null 检 查 ， 而 不 是 检查 hasNext( ) ° 

通 弟 你 应 该 选用 基于 服务 端的 锁定 ， 因 为 : 

它 城 少 了 重复 代码 一 一 采用 基于 客户 代码 的 锁定 ， 每 个 客户 站 都 
要 正确 锁定 服务 端 。 把 锁定 代码 放 到 服务 器 ， 客 户 病 吏 能 目 由 使 用 对 
象 ， 不 必 费 心 编 写 额 外 的 锁定 代码 ; 

它 提 升 了 性 能 一 一 在 单线 程 部 署 中 ， 可 以 用 非 多 线程 安全 服务 端 
代码 奉 代 线程 安全 客户 端 ， 从 而 省 去 花 销 ; 

它 减 少 了 出 错 的 可 能 性 一 一 只 会 有 一 个 程序 员 起 记 上 锁 ，; 

它 执 行 了 单一 策略 一 一 该 党 略 只 在 服务 端 这 一 处 地 方 实施 ， 而 不 
是 在 许多 地 方 《每 个 客户 端 ) 实施 ; 

它 缩 减 了 共享 变量 的 作用 范围 一 一 客户 端 不 必 关 心 它们 或 它们 是 
如 何 锁定 的 。 一 切 都 隐藏 在 服务 端 。 如 末 出 错 ， 要 侦查 的 范围 就 小 多 
Te 

如 条 你 无 法 修改 服务 端 代码 又 该 如 何 ? 

使 用 ADAPTER 模 式 修改 API， 讨 加山 定 ; 

public class ThreadSafeIntegerlterator { 


private IntegerIterator iterator = new IntegerIterator(); 
public synchronized Integer getNextOrNull() { 
if(iterator.hasNext()) 
return iterator.next(); 
return null; 
j 
j 
更 好 的 方法 是 使 用 线程 安全 的 群集 和 扩展 接口 。 


A.5 提 HE 


假设 我 们 打算 连接 上 网 ， 从 一 个 URL 列 表 中 读 取 一 组 页 面 的 内 
容 。 读 到 一 个 页 面 时 ， 解 析 该 页 面 并 得 到 一 些 统计 结果 。 读 完 所 有 页 
面 后 ， 打 印 出 一 份 提要 报表 。 
下 面 的 类 返回 给 定 URL 的 页 面 内 容 : 
public class PageReader { 
Ia 
public String getPageFor(String url) { 
HttpMethod method = new GetMethod(url); 
try 1 
httpClient.executeMethod(method); 


String response = method.getResponseBodyAsString(); 
return response; 

} catch (Exception e) { 
handle(e); 

} finally { 


method.releaseConnection(); 


} 
Te HURLIA Cas FET TAN ASA Cae: 
public class Pagelterator { 

private PageReader reader; 

private URLIterator urls; 

public Pagelterator(PageReader reader, URLIterator urls) { 


this.urls = urls; 
this.reader = reader; 
} 
public synchronized String getNextPageOrNull() { 
if (urls.hasNext()) 
getPageFor(urls.next()); 
else 
return null; 
} 
public String getPageFor(String url) { 
return reader.getPageFor(url); 
} 
} 
Pagelterator 的 一 个 实体 可 为 多 个 不 同 线程 共享 ， 每 个 线程 使 用 自 
己 的 PageReader 实 体 读 取 并 解析 从 大 代 絮 中 得 到 的 页 面 。 
注意 ， 我 们 把 synchronized 代 码 块 的 数量 限制 在 小 范围 之 内 。 它 只 
包括 深 人 处 于 Pagelterator 内 部 的 临界 区 。 最 好 是 尽 可 能 少 地 使 用 同步 。 


A.5.1 单线 程 条 件 下 的 吞吐 量 


来 做 个 简单 计算 。 鉴 于 讨论 的 目的 ， 假 定 : 

获取 一 个 页 面 的 VO 时 间 (平均 ) 是 1s; 

解析 一 个 页 面 的 处 理 时 间 (平均 ) 是 0.5s:; 

LO 操作 不 耗费 处 理 胡 能力， 而 解析 页 面 耗费 100% 处 理 紫 能 

对 于 单个 线程 要 处 理 的 N 个 页 面 ， 总 的 执行 时 间 为 1.5s*N。 图 A-1 
显示 了 13 个 页 面 或 大 概 19.5s 的 快照 。 


单线 程 


解析 页 面 [| [| IBI [| IBI [| INI [| [Lil 


获得 页 面 LIILIIIIII/III/I/II/II/I//II/I//I/I/III/I/I/I/I/I/I\II{{I{K{K{I 


图 A-1 单线 程 
A.5.2 多 线程 条 件 下 的 吞吐 量 


如 果 能 够 以 任意 次 序 获 得 页 面 并 独立 处 理 页 面 ， 束 有 可 能 利用 多 
线程 提升 吞吐 量 。 如 果 我 们 使 用 三 个 线程 会 如 何 ? 在 同一 时 间 内 能 获 
取 多 少 个 页 面 呢 ? 

如 你 在 图 A-2 中 所 见 ， 多 线程 方案 中 与 处 理 占 能 力 有 关 的 页 面 解析 
操作 可 以 和 与 WO 有 关 的 页 面 读 取 操作 个 加 进行 。 在 理想 状态 下 ， 这 意 
味 看 处 理 右 力 尽 其 用 。 每 个 耗 时 一 秒 钟 的 页 面 读 取 操 作 部 与 两 次 解析 
操作 县 加 进行 。 这 样 ， 我 们 吏 能 在 每 秒 钟 内 处 理 两 个 页 面 ， 即 三 倍 于 
单线 程 方案 的 吞吐 量 。 


线程 


解析 页 面 [| [L TI [LI] [LI] [LI] [Ly] [LI] 


获得 页 面 LIIIIIIIIIII/I/I/I/II/I/I/I/I//I/I/II/II/IIII{II{KI 


线程 2 
解析 页 面 [L FLFLFLFLFLFLFILFILPLILILE 
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线程 3 


解析 页 面 [| [LII [LII [| [| [| [LI] [LII | 


i | 


图 A-2 三 个 并 发 线程 


A.6 死 锁 


想象 一 个 拥有 两 个 有 限 共享 资源 池 的 Web 应 用 程序 。 

一 个 用 于 本 地 临时 工作 存储 的 数据 库 连 接 池 ; 

一 个 用 于 连接 到 主 存储 库 的 MQ 池 。 

假定 该 应 用 中 有 两 个 操作 : 创建 和 更 新 。 

创建 一 一 获取 到 主 存储 库 和 数据 库 的 连接 。 与 主 存储 库 协 调 ， 并 
把 工作 保存 到 本 地 临时 工作 数据 库 ; 

更 新 一 一 先 获 取 到 数据 库 的 连接 ， 再 获取 到 主 存储 库 的 连接 。 从 
临时 工作 数据 库 中 读 取 数据 ， 再 发 送 给 主 存储 库 。 

如 果 用 户 数 量 多 于 池 的 大 小 会 怎样 ? 假设 每 个 池 中 能 容纳 10 个 资 
源 。 

有 10 个 用 户 尝 斌 创建， 获取 了 10 个 数据 库 连 授 ， 每 个 线程 在 获取 
到 数据 库 连 接 之 后 、 获 取 到 主 存储 库 连 接 之 前 都 被 打 断 ; 

有 10 个 用 户 尝试 更 新 ， 获 取 了 10 个 主 存储 库 连 接 ， 每 个 线程 在 获 
取 到 主 存储 库 连 接 之 后 、 获 取 到 数据 库 连 接 之 前 都 会 被 打 断 ; 

现在 那 10 个 “创建 ”线程 必须 等 得 获取 主 存储 库 连 接 ， 但 那 10 个 “更 
新 ”线程 必须 等 竺 获取 数据 库 连 接 ; 

死 锁 。 系 统 永远 无 法 恢复 。 

这 听 起 来 不 太 会 出 现 ， 但 谁 会 想 要 一 个 每 隔 一 周 束 僵 在 那里 不 动 
的 系统 呢 ? 谁 想 要 调试 出 现 了 难以 复 现 的 症状 的 系统 呢 ? 这 种 问题 突 
然 发 生 ， 然 后 得 化 上 好 几 个 星期 才能 解决 。 

典型 的 “解决 方案 ?是 加 入 调试 语句 ， 发 现 问 题 。 当 然 ， 调 试 语 名 
对 代码 的 修改 足以 令 死 锁 在 不 同情 况 下 发 生 ， 而 且 要 几 个 月 后 才 会 再 


出 现 [4] 。 

要 真正 地 解决 死 锁 问题 ， 我 们 需要 理解 死 锁 的 原因 。 死 锁 的 发 生 
需要 4 个 条 件 : 

HJF; 

上 锁 及 等 待 ; 

无 抢先 机 制 ; 

循环 等 待 。 


A.6.1 EJF 


当 多 个 线程 需要 使 用 同一 资源 ， 且 这 些 资 源 满足 下 列 条 件 时 ， 互 
FARRE” 

无 法 在 同一 时 间 为 多 个 线程 所 用 |; 

数量 上 有 限制 。 

这 种 资源 的 闸 见 例子 是 数据 库 连 授 、 打 开 后 用 于 写 入 的 文件 、 记 
A BL BE fe > 


A.6.2 上 锁 及 等 待 


当 某 个 线程 获取 一 个 资源 ， 在 获取 到 其 他 全 部 所 需 资 源 并 完成 其 
工作 之 前 ， 不 会 释放 这 个 资源 。 


A.6.3 无 抢先 机 制 


线程 无 法 从 其 他 线程 处 夺取 资源 。 一 个 线程 持 有 资源 时 ， 其 他 线 
程 获得 这 个 资源 的 唯一 手段 束 是 等 待 该 线程 释放 资源 。 


A.6.4 í 和 


这 也 被 称 为 “死命 拥抱 *”。 想 象 两 个 线程 ，T1 和 T2， 还 有 两 个 资 
源 ，R1 和 R2。T1 拥 有 R1，T2 拥 有 R2。T1 需 要 R2，T2 需 要 R1。 如 此 就 
出 现 了 如 图 A-3 所 示 的 情形 。 

这 4 种 条 件 都 是 死 锁 所 必需 的 。 只 要 其 中 一 个 不 满足 ， 死 锁 就 不 会 
发 生 。 
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图 A-3 循环 等 待 


A.6.5 不 互 斥 


避免 死 锁 的 一 种 舍 略 是 规避 互 斤 条 件 。 你 可 以 : 
使 用 允许 同时 使 用 的 资源 ， 如 AtomicInteger; 
增加 资源 数量 ， 使 其 等 于 或 大 于 苋 搜 线程 的 数量 ; 


在 获取 资源 之 前 ， 检 查 是 否 可 用 。 

Delle, SSR ER, ANSE o MASSE 
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气 ， 还 有 3 个 其 他 条 件 呢 。 


A.6.6 不 上 锁 及 等 待 


如 有 果 拒 绝 等 待 ， 束 能 消除 死 锁 。 在 获得 资源 之 前 检查 资源 ， 如 采 
遇 到 某 个 繁忙 资源 ， 就 释放 所 有 资源 ， 重 新 来 过 。 

这 种 手段 带 来 几 个 潜在 问题 : 

线程 饥饿 一 一 某 个 线程 一 直 无 法 获得 它 所 需 的 资源 ( 它 可 能 需要 
某 种 很 少 能 同时 获得 的 资源 组 合 ) ， 

活 锁 一 一 儿 个 线程 可 能 会 前 后 相连 地 要 求 获得 某 个 资源 ， 然 后 再 
释放 一 个 资源 ， 如 此 循环 。 这 在 单纯 的 CPU 任务 排列 算法 中 尤其 有 可 
能 出 现 ( 想 想 藤 入 式 设备 或 单纯 的 手写 线程 平衡 算法 ) o 

二 者 都 能 导致 较 差 的 吞吐 量 。 第 一 个 的 结果 是 CPU 利用 率 低 ， 第 
二 个 的 结果 是 较 高 但 无 用 的 CPU 利用 率 。 

尽管 这 种 策略 听 起 来 没 效 率 ， 但 也 好 过 没有 。 至 少 ， 如 果 其 他 方 
案 不 奏效 ， 这 种 手段 几乎 总 可 以 用 上 。 


A.6.7 满足 抢先 机 制 


避免 死 锁 的 另 一 策略 是 允许 线程 从 其 他 线程 上 和 夺取 资源 。 这 通常 
利用 一 种 简单 的 请 求 机 制 来 实现 。 当 线程 发 现 资 源 演 忙 ， 束 要 求 其 拥 
有 者 释放 之 。 如 采 拥 有 者 还 在 等 待 其 他 资源 ， 束 释放 全 部 资源 并 重新 
ZO 
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A.6.8 不 做 循环 等 待 


这 是 避免 死 锁 的 最 常用 手段 。 对 于 多 数 系 统 ， 它 只 要 求 一 个 为 各 
方 认 同 的 约定 。 

在 上 面 的 例子 中 线程 1 同时 需要 资源 1 和 资源 2、 线 程 2 同时 需要 资 
源 2 和 资源 1， 只 要 强制 线程 1 和 线程 2 以 同样 次 序 分 配 资源 ， 循 环 等 待 
MISERA © 

更 普遍 地 ， 如 果 所 有 线程 都 认同 一 种 资源 获取 次 序 ， 并 按照 这 种 
次 序 获 取 资 源 ， 死 锁 束 不 会 发 生 。 就 像 其 他 策略 一 样 ， 这 也 会 有 问 
题 : 

获取 资源 的 次 序 可 能 与 使 用 资源 的 次 序 不 匹配 ; 一 开始 获取 的 资 
源 可 能 在 最 后 才 会 用 到 。 这 可 能 导致 资源 不 必要 地 被 长 时 间 锁 定 ; 

有 时 无 法 强求 资源 获取 顺序 。 如 果 第 二 个 资源 的 ID 来 自 对 第 一 个 
资源 操作 的 结果 ， 获 取 次 序 也 无 从 谈 起 。 

有 许多 避免 死 锁 的 方法 。 有 些 会 导致 饥 俄 ， 另 外 一 些 会 导致 对 
CPU 能 力 的 大 量 耗 费 和 降低 啊 应 率 。TANSTAAEFL[5]! 

sii... 再 加 以 调整 和 试验 ， 

获得 判断 最 佳 策略 所 需 的 洞 见 的 正道 。 


A.7 测 试 多 线程 代 例 


皇 么 才能 编写 显示 以 下 代码 有 错 的 测试 呢 ? 
01: public class ClassWithThreadingProblem { 
02: int nextId; 

03: 

04: public int takeNextId() 1 


05: return nextId++; 


06: } 

07: } 

下 面 是 对 能 证 明 上 列 代码 有 错 的 测试 的 描述 : 
记 住 nextId 的 当前 值 ; 


创建 两 个 线程 ， 每 个 都 调用 takeNextId( ) 一 次 ; 

验证 nextId 比 开始 时 大 2; 

持续 运行 ， 直 至 发 现 nextId 只 比 开始 时 大 1 为 止 。 
代码 清单 A-2 展 示 了 这 样 一 个 测试 : 

代码 清单 A-2 ClassWithThreadingProblemTest.java 
01: package example; 


02: 

03: import static org.junit.Assert.fail; 
04: 

05: import org.junit.Test; 

06: 


07: public class ClassWithThreadingProblemTest { 
08: @Test 
09: public void — twoThreadsShouldFailEventually() throws 
Exception 1 
10: final  ClassWithThreadingProblem 
classWithThreadingProblem 
= new ClassWithThreadingProblem(); 


11: 
12: Runnable runnable = new Runnable() { 
13: public void run() 1 


14: classWithThreadingProblem.takeNextId(); 


16: }; 

17: 

18: for(inti-0; i<50000;++i) { 

19: int startingId = classWithThreadingProblem.lastId; 

20: int expectedResult = 2 + startingId; 

21: 

22: Thread t1 = new Thread(runnable); 

23: Thread t2 = new Thread(runnable); 

24: t1.start(); 

25: t2.start(); 

26: t1.join(); 

27: t2.join(); 

28: 

29: int endingld = classWithThreadingProblem.lastId; 

30: 

31: if (endingid !=  expectedResult) 

32: return; 

33: j 

34: 

35: fail("Should have exposed a threading issue but 
it did  not."); 

36: j 

37: } 


3& A-3 代码 清单 A-2 的 注解 


代码 行 描述 


10 创建 ClassWithThreadingProblem 的 单个 实体 。 注 意 ， 必 须 使 用 final 关键 字 ， 因 为 要 在 一 个 匿 
名 内 部 类 中 用 到 它 

12~16 创建 一 个 匿名 内 部 类 ， 该 类 用 到 ClassWithThreadingProblem 的 单个 实体 

18 运行 这 段 代码 “足够 多 ”次 以 展示 代码 失败 ， 但 不 要 多 到 “ 花 太 长 时 间 ”。 这 是 种 平衡 行为 ; 
我 们 不 想 等 太 久 。 选 择 这 个 数字 有 点 难 一 一 尽管 我 们 稍 后 会 看 到 能 够 极 大 地 降低 这 个 数字 

19 记 住 开始 时 的 值 。 这 个 测试 试图 证 明 ClassWithThreadingProblem 中 的 代码 有 错误。 如 果 测 试 
通过 ， 它 就 证 明了 这 一 点 。 如 果 测 试 失败 ， 它 就 没 能 证 明代 码 出 错 

20 我 们 期 望 最 终 值 比 当前 值 大 2 

22 一 23 创建 两 个 线程 ， 都 使 用 我 们 在 第 12~16 行 创 建 的 对 象 。 这 样 两 个 线程 就 有 可 能 用 到 
ClassWithThreadingProblem 的 单个 实体 ， 互 相干 涉 

24 一 25 开始 运行 两 个 线程 

26 一 27 在 检查 结果 之 前 等 待 两 个 线程 结束 

29 记录 真实 的 最 终 值 


31~32 |endingld 是 否 与 期 待 值 不 一 样 ? 如 果 是 ， 测 试 结束 一 一 我 们 已 经 证 明了 代码 有 错误 。 如 果 不 
是 ， 再 试 一 次 


35 到 达 这 一 步 ， 测 试 无 法 证 明 产 品 代码 在 “合理 范围 ”的 时 间 内 出 错 ; 测试 失败 了 。 要 么 是 代 
码 没 错 ， 要 么 是 没有 运行 足够 多 次 ， 错 误 条 件 还 没 满 足 
这 个 测试 当然 设置 了 满足 并 发 更 新 问题 发 生 的 条 件 。 不 过 ， 问 题 
发 生得 如 此 频繁 ， 测 试 也 就 极 有 可 能 侦 测 不 到 。 
实际 上 ， 要 真正 侦 测 到 问题 ， 需 要 将 循环 数量 设置 到 100 万 次 以 
上 上。 即便 是 这 样 ， 在 10 个 100 万 次 循环 的 执行 中 ， 错 误 也 只 发 生 了 一 
次 。 这 意味 着 我 们 可 能 要 把 循环 次 数 设置 为 超过 亿 次 才能 获得 可 靠 的 
失败 证 明 。 要 等 多 久 呢 ? 
即便 我 们 调 优 测试 ， 在 单 台 机 器 上 得 到 可 靠 的 失败 证 明 ， 我 们 可 
能 还 需要 用 不 同 的 值 来 重新 设置 测试 ， 得 到 在 其 他 机 器 、 操 作 系 统 或 
不 同 版 本 的 JVM 上 的 失败 证 明 。 
而 且 这 只 是 个 简单 问题 。 如 果 连 这 个 简单 问题 都 无 法 轻易 获得 出 
间 证 明 ， 我 们 怎么 能 真正 侦 测 复 灯 问题 呢 ? 
我 们 能 用 什么 手段 来 证 明 这 个 简单 错误 呢 ? 而且， 更 重要 的 是 ， 
我 们 如 何 能 写 出 证 明 更 复杂 代码 中 的 错误 的 测试 呢 ? 我 们 怎样 才能 在 
不 知道 从 何 处 着 手 时 知道 代码 是 否 出 错 了 呢 ? 下 面 是 一 些 想 法 : 


罕 特 卡 洛 测试 。 测 试 要 灵活 ， 便 于 调整 。 多 次 运行 测试 一 一 在 一 
台 测 试 服务 右上 一 一 随机 改变 调整 值 。 如 果 测 试 失败 ， 代 码 整 有 错 。 
确保 及 早 编 写 这 些 测试 ， 好 让 持续 集成 服务 右 尽 快 开始 运行 测试 。 男 
外 ， 确 认 小 心 记录 了 在 何 种 条 件 下 测试 失败 。 

在 每 种 目标 部 署 平 台 上 运行 测试 。 重 复 运行 。 持 续 运 行 。 测 试 在 


不 失败 的 前 提 下 运行 得 越久 ， 就 越 能 说 明 
- 生产 代码 正确 ; 
或 ; 


- 测 弃 不 足以 又 露 问题 。 
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即便 你 做 了 所 有 这 些 ， 还 是 不 见得 有 很 好 的 机 会 发 现代 码 中 的 线 
程 问题 。 最 阴险 的 问题 拥有 很 小 的 截面 ， 在 十 亿 次 执行 中 只 会 发 生 一 
次 。 这 类 错误 是 复 洒 系统 的 最 梦 。 


A.8 测试 线程 IL 


IBM 提 供 了 一 个 名 为 ConTest 的 工具 [6]。 它 能 对 类 进行 装置 ， 令 非 
线程 安全 代码 更 有 可 能 失败 。 

我 们 与 BM 或 开发 ConTest 的 团队 没有 直接 关系 。 有 位 同事 发 现 了 
这 个 工具 。 在 用 了 几 分 钟 后 ， 我 们 发 现 目 己 发 现 线程 问题 的 能 力 得 到 
了 很 大 提升 。 

下 面 是 使 用 ConTest 的 简要 步骤 ; 

编写 测试 和 生产 代码 ， 确 保有 专门 模拟 多 用 户 在 多 种 负载 情况 下 
操作 的 测试 ， 如 上 文 所 壕 ; 

用 ConTest 装 置 测试 和 生产 代码 ; 


运行 测试 。 

用 ConTest 淡 置 代码 后 ， 原 本 和 干 万 次 循环 才能 暴露 一 个 错误 的 比率 
提升 到 30 次 循环 就 能 找到 错误 。 以 下 是 装置 代码 后 的 几 次 测试 运行 结 
果 值 : 13、23、0、54、16、14、6、69、107、49 和 2。 显 然 装 置 后 的 
类 更 加 容易 和 可 靠 地 被 证 明 失 败 。 


A.9 小 结 


本 划 只 是 在 并 发 编程 广阔 而 可 怕 的 领地 上 的 短暂 逗留 时 了。 我 们 
只 触及 了 地 表 。 我 们 在 这 里 强调 的 ， 只 是 保持 并 发 代码 整洁 的 一 些 规 
程 ， 如 有 果 要 编写 并 发 系统 ， 还 有 许多 东西 要 学 。 建 议 从 Doug Lea 的 大 
VE Concurrent Programming in Java:Design Principles and Patterns 开 始 
val 

在 本 章 中 ， 我 们 谈 到 并 发 更 新 ， 还 有 清理 及 避免 同步 的 规程 。 我 
们 谈 到 线程 如 何 提升 与 MO 有 关 的 系统 的 吞吐 量 ， 展 示 了 获得 这 种 提升 
的 整洁 技术。 我 们 谈 到 死 锁 及 干净 地 避免 死 锁 的 规程 。 最 后 ， 我 们 谈 
到 通过 装置 代码 暴露 并 发 问题 的 策略 。 


A.10 教程 ， 完 整 代码 范例 


A.10.1 客户 端 /服务 器 非 线程 代 
代码 清单 A-3 Serverjava 


package com.objectmentor.clientserver.nonthreaded; 


import java.io.IOException; 


import java.net.ServerSocket; 

import java.net.Socket; 

import java.net.SocketException; 

import common.MessageUtils; 

public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 


public Server(int port, int millisecondsTimeout) throws IOException 


serverSocket = new ServerSocket(port); 
serverSocket.setSoTimeout(millisecondsTimeout); 
} 
public void run() { 
System.out.printf(" Server Starting"); 
while (keepProcessing) 1 
try 1 
System.out.printf("accepting client\n"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process(socket); 
} catch (Exception e) { 
handle(e); 


} 
private void handle(Exception e) { 


if (!(e instanceof SocketException)) { 


e.printStackTrace(); 


} 
public void stopProcessing() { 
keepProcessing = false; 
closeIgnoringException(serverSocket); 
} 
void process(Socket socket) { 
if (socket == null) 
return; 
try 1 
System.out.printf(" Server: getting message\n"); 
String message = MessageUtils.getMessage(socket); 
System.out.printf(" Server: got message: 96s", message); 
Thread.sleep(1000); 
System.out.printf(" Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 
} catch (Exception e) { 
e.printStackTrace(); 


} 


private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 


} catch (IOException ignore) 1 
} 
} 


private void closeIgnoringException(ServerSocket serverSocket) { 
if (serverSocket != null) 
try { 
serverSocket.close(); 
} catch (IOException ignore) { 
} 


} 

代码 清单 A-4 ClientTest.java 

package com.objectmentor.clientserver.nonthreaded; 

import java.io.IOException; 

import java.net.ServerSocket; 

import java.net.Socket; 

import java.net.SocketException; 

import common.MessageUtils; 

public class Server implements Runnable { 
ServerSocket serverSocket; 
volatile boolean keepProcessing = true; 


public Server(int port, int millisecondsTimeout) throws IOException 


serverSocket = new ServerSocket(port); 
serverSocket.setSoTimeout(millisecondsTimeout); 


} 
public void run() { 


System.out.printf(" Server Starting"); 
while (keepProcessing) 1 
try 1 
System.out.printf("accepting client\n"); 
Socket socket = serverSocket.accept(); 
System.out.printf("got client\n"); 
process(socket); 
} catch (Exception e) { 
handle(e); 


} 
private void handle(Exception e) 1 
if (!(e instanceof SocketException)) { 


e.printStackTrace(); 


} 
public void stopProcessing() { 
keepProcessing = false; 
closeIgnoringException(serverSocket); 
} 
void process(Socket socket) { 
if (socket == null) 
return; 
try 1 
System.out.printf(" Server: getting message\n"); 


String message = MessageUtils.getMessage(socket); 


System.out.printf(" Server: got message: %s\n", message); 
Thread.sleep(1000); 
System.out.printf(" Server: sending reply: 96s", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 

} catch (Exception e) 1 
e.printStackTrace(); 


} 


private void closeIgnoringException(Socket socket) { 
if (socket != null) 
try { 
socket.close(); 
} catch (IOException ignore) { 
} 


private void closeIgnoringException(ServerSocket serverSocket) { 
if (serverSocket != null) 
try { 
serverSocket.close(); 
} catch (IOException ignore) { 
} 


} 
代码 清单 A-5 MessageUtils.java 


package common; 


import java.io.IOException; 
import java.io.InputStream; 
import java.io.ObjectInputStream; 
import java.io.ObjectOutputStream; 
import java.io.OutputStream; 
import java.net.Socket; 
public class MessageUtils { 
public static void sendMessage(Socket socket, String message) 
throws IOException { 
OutputStream stream = socket.getOutputStream(); 
ObjectOutputStream oos = new ObjectOutputStream(stream); 
oos.writeUTF(message); 
oos.flush(); 
} 
public static String getMessage(Socket socket) throws IOException { 
InputStream stream = socket.getInputStream(); 
ObjectInputStream ois = new ObjectInputStream(stream); 


return ois.readUTF(); 


A.10.2 使 用 线程 的 客户 端 /服务 器 代 


把 服务 器 修改 为 使 用 多 线程 ， 只 需要 对 处 理 消 息 进 行 修改 即 可 
(新 的 代码 行 用 粗 体 标 出 ) : 


void process(final Socket socket) { 


if (socket == null) 


return; 
Runnable clientHandler = new Runnable() 1 
public void run() { 
try 1 
System.out.printf(" Server: getting message\n"); 
String message = MessageUtils.getMessage(socket); 
System.out.printf(" Server: got message: 96s", message); 
Thread.sleep(1000); 
System.out.printf(" Server: sending reply: %s\n", message); 
MessageUtils.sendMessage(socket, "Processed: " + message); 
System.out.printf("Server: sent\n"); 
closeIgnoringException(socket); 
} catch (Exception e) 1 
e.printStackTrace(); 


} 
}; 
Thread clientConnection = new Thread(clientHandler); 


clientConnection.start(); 


[I] EE: 你 可 以 目 行 验证 修改 之 前 和 之 后 的 代码 。 复 查 前 文 的 非 多 线 
程 代码 。 复 查 之 后 的 多 线程 代码 。 


[2]. 原 注 : 这 说 得 有 扩 简 单 了 。 鉴 于 讨论 的 目的 ， 我 们 殊 用 这 个 位 化 模 
2 


[3]. 原 注 : 实际 上 ， Iterator 接 口 天生 不 是 线程 安全 的 。 它 并 不 为 多 线程 
而 设计 ， 所 以 出 现 这 种 情况 也 不 奇怪 。 


[4]. 原 注 : 例如 ， 有 人 添加 了 一 些 调 斌 输出， 问题“ 不 见 了 ”。 调试 代码 
“修正 ?了 问题 ， 其 实 问题 还 在 系统 中 存在 。 


[5]. 原 注 : 世上 没有 免费 的 午餐 (There ain't no such thing as a free 


lunch) 。 


[6]. 原 注 : 


http://www.haifa.ibm.com/projects/verification/contest/index.html ° 


[7]. 原 注 : Ol [Lea99]p.191 ° 


附录 B org.jfree.date.SerialDate 


代码 清单 B-1 SerialDate.Java 


1 p 
* JCommon:a free general purpose class library for the Java(tm) platform 
* 
4 * 
5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
6 * 
7 * Project Info: http://www.jfree.org/jcommon/index.html 
8 + 
9 *Thislibraryisfree software; you can redistribute it and/or modify it 
10 *underthe terms of the GNU Lesser General Public License as published by 
11 * the Free Software Foundation; either version 2.1 of the License, or 
12 *(atyouroption) any later version. 
13 * 
14 * This library is distributed in the hope that it will be useful, but 
15 * WITHOUT ANY WARRANTY; without even the implied ^ warranty of 
MERCHANTABILITY 
16 *orFITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
17 * License for more details. 
18 * 
19 *Youshould havereceiveda copy of the GNU Lesser General Public 
20 * License along with this library; if not, write tothe Free Software 
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
22 *USA. 


23 


* 


24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
correct 
46 
47 
48 
49 
50 
(DG); 
51 
52 
53 
54 
55 
56 


*[Javaisa trademark or registered trademark of Sun Microsystems, Inc. 


* in the United States and other countries.] 


* (C) Copyright 2001-2005, by Object Refinery Limited. 

* 

* Original Author: David Gilbert (for Object Refinery Limited); 
* Contributor(s): 2 


* 


* $Id: SerialDate.java,v 1.7 2005/11/03 09:25:17 mungady Exp $ 


* 


* Changes (from 11-Oct-2001) 

* 11-Oct-2001: Re-organised the class and moved itto new package 

T com.jrefinery.date (DG); 

* 05-Nov-2001 : Added a getDescription() method, and eliminated NotableDate 

y class (DG); 

* 12-Nov-2001 : IBD requires setDescription() method, now that NotableDate 


* class is gone (DG); Changed getPreviousDayOfWeek(), 

i: getFollowingDayOfWeek() and getNearestDayOfWeek() to 
n bugs (DG); 

* 05-Dec-2001 : Fixed bugin SpreadsheetDate class (DG); 


* 29-May-2002 : Moved the month constants intoa separate interface 
ù (MonthConstants) (DG); 
* 27-Aug-2002 : Fixed bug in addMonths() method, thanks to N???levka Petr 


* 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

* 13-Mar-2003 : Implemented Serializable (DG); 

* 29-May-2003 : Fixed bug in addMonths method (DG); 

* 04-Sep-2003 : Implemented Comparable. Updated the isInRange javadocs (DG); 
* 05-Jan-2005 : Fixed bug in addYears() method (1096282) (DG); 


* 


57 
58 


"f 


59 package org.jfree.date; 


60 


61 import java.io.Serializable; 


62 import java.text.DateFormatSymbols; 


63 import java.text.SimpleDateFormat; 


64 import java.util.Calendar; 


65 import java.util.GregorianCalendar; 


66 


67 /** 


68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 


* 


* 


* 


* 


* 


An abstract class that defines our requirements for manipulating dates, 
without tying downa particular implementation. 

«p» 

Requirement 1: match atleast what Excel does for dates; 
Requirement 2: class is immutable; 

<P> 

Why not just use java.util.Date? We will, when it makes sense. At 


java.util.Date can be *too* precise -it represents an instant in time, 


accurate to 1/1000th of a second (with the date itself depending onthe 


times, 


time-zone). Sometimes we just want to represent a particular day (e.g. 21 


January 2015) without concerning ourselves about the time of day, or the 


time-zone, or anything else. That's what we've defined SerialDate for. 
<P> 
You can call getInstance() to geta concrete subclass of SerialDate, 


without worrying about the exact implementation. 


* @author David Gilbert 


zt 


86 public abstract class SerialDate implements Comparable, 


87 
88 
89 
90 
91 


Serializable, 


MonthConstants { 


/** For serialization. */ 
private static final long serialVersionUID = -293716040467423637L; 


92 


93 /** Date format symbols. */ 

94 public static final DateFormatSymbols 

95 DATE FORMAT SYMBOLS new 
SimpleDateFormat().getDateFormatSymbols(); 

96 

97 /** 'The serial number for 1 January 1900. */ 

98 public static final int SERIAL. LOWER, BOUND - 2; 

99 

100 /** The serial number for 31 December 9999. */ 

101 public static final int SERIAL. UPPER, BOUND = 2958465; 

102 

103 /** The lowest year value supported by this date format. */ 

104 public static final int MINIMUM_YEAR_SUPPORTED = 1900; 

105 

106 /** The highest year value supported by this date format. 

107 public static final int MAXIMUM_YEAR_SUPPORTED = 9999; 

108 

109 /** Useful constant for Monday. Equivalent to java.util.Calendar MONDAY. 
sii 

110 public static final int MONDAY = Calendar MONDAY; 

111 

112 poe 

113 * Useful constant for Tuesday. Equivalent to java.util.Calendar. TUESDAY. 

114 */ 

115 public static final int TUESDAY = Calendar. TUESDAY; 

116 

117 pre 

118 * Useful constant for Wednesday. Equivalent to 

119 * java.util.Calendar WEDNESDAY. 

120 si 

121 public static final int WEDNESDAY = Calendar WEDNESDAY; 

122 

123 PER 


124 * Useful constant for Thrusday. Equivalent to java.util.Calendar THURSDAY. 


125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 


*/ 
public static final int THURSDAY = Calendar. THURSDAY; 


/** Useful constant for Friday. Equivalent to  java.util.Calendar. FRIDAY. */ 
public static final int FRIDAY = Calendar.FRIDAY; 


[PE 

* Useful constant for Saturday. Equivalent to java.util.Calendar SATURDAY. 
*/ 

public static final int SATURDAY = Calendar.SATURDAY; 


/** Useful constant for Sunday. Equivalent to  java.util.CalendarSUNDAY. */ 
public static final int SUNDAY = Calendar.SUNDAY; 


/** The number of days in each month in non leap years. */ 
static final int[] LAST DAY OF MONTH = 
10, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}; 


/** The number of days ina  (non-leap) year up to the end ofeach month. */ 
static final intl] AGGREGATE DAYS TO END OF MONTH = 
(0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 


/** The number of daysina yearup to the end of the preceding month. */ 
static final int[] AGGREGATE DAYS TO END OF PRECEDING MONTH = 
(0,0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 


/** The number of daysina leap year up to the end of each month. */ 
static final int[] LEAP. YEAR. AGGREGATE DAYS TO END OF MONTH = 
(0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366}; 


/炒米 
* The number of days in a leap year up to the end of the preceding month. 
pi 
static final int[] 
LEAP YEAR, AGGREGATE DAYS TO END OF PRECEDING MONTH = 


160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 


(0,0, 31, 60, 91, 121, 152,182, 213, 244, 274, 305, 335, 


/** A useful constant for referring to the first weekin amonth. */ 
public static final int FIRST WEEK. IN MONTH = 1; 


/** A useful constant for referring to the second week in a month. */ 
public static final int SECOND WEEK. IN MONTH = 2; 


/** A useful constant for referring to the third week in a month. */ 
public static final int THIRD WEEK, IN MONTH - 3; 


/** A useful constant for referring to the fourth week in a month. */ 
public static final int FOURTH, WEEK IN MONTH = 4; 


/** A useful constant for referring to the last week ina month. */ 
public static final int LAST_WEEK_IN_MONTH = 0; 


/** Useful range constant. */ 
public static final int INCLUDE_NONE = 0; 


/** Useful range constant. */ 
public static final int INCLUDE_FIRST = 1; 


/** Useful range constant. */ 
public static final int INCLUDE_SECOND = 2; 


/** Useful range constant. */ 
public static final int INCLUDE_BOTH = 3; 


[res 
* Useful constant for specifying a day of the week relative to a fixed 
* date. 

T 
public static final int PRECEDING =  -1; 


366}; 


195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 


pe 
* Useful constant for specifying a day of the week relative toa fixed 
* date. 

ui 

public static final int NEAREST = 0; 


pe 
* Useful constant for specifying a day of the week relative toa fixed 
* date. 

x 

public static final int FOLLOWING = 1; 


/** A description for the date. */ 


private String description; 


[ee 
* Default constructor. 
*/ 

protected SerialDate() { 
} 


/炒米 


* Returns <code>true</code> if the supplied integer code repre sents a 
* valid day-of-the-week, and <code>false</code> otherwise. 


* 


* @param code the code being checked for validity. 

x 

* @return <code>true</code> if the supplied integer code represents a 
* valid day-of-the-week, and <code>false</code> otherwise. 
TA 

public static boolean isValidWeekdayCode(final int code) 1 


switch(code) { 
case SUNDAY: 
case MONDAY: 


230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 


case TUESDAY: 

case WEDNESDAY: 

case THURSDAY: 

case FRIDAY: 

case SATURDAY: 
return true; 

default: 


return false; 


/[** 
* Converts the supplied string to a day of the week. 


* 


* @params a string representing the day of the week. 

x 

* @return <code>-1</code> if the string is not convertable, the day of 
d the week otherwise. 

i 

public static int stringToWeekdayCode(String s) { 


final String[] shortWeekdayNames 
= DATE FORMAT SYMBOLS.getShortWeekdays(); 
final String[] weekDayNames = DATE FORMAT SYMBOLS.getWeekdays(); 


int result = -1; 
s = s.trim(); 
for (int i = 0; i < weekDayNames.length; i++) { 
if (s.equals(shortWeekdayNames[i])) { 
result = i; 
break; 
} 
if (s.equals(weekDayNames[i])) { 


result = i; 


265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 


break; 


return result; 


/炒米 
* Retumsa string representing the supplied day-of-the-week. 
* <P> 


* Need to find a better approach. 


* 


* @param weekday the day of the week. 


* 


* @returna string representing the supplied day-of-the-week. 
di 
public static String weekdayCodeToString(final int weekday) { 


final String[] weekdays = DATE_FORMAT_SYMBOLS.getWeekdays(); 


return weekdays[weekday]; 


Vici 


* Returns an array of month names. 


* 


* @return an array of month names. 
x 
public static String[] getMonths() { 


return getMonths(false); 


[E* 


300 * Returns an array of month names. 


301 * 

302 * @param shortened a flag indicating that shortened month names should 
303 » be returned. 

304 T 

305 * @return an array of month names. 

306 */ 

307 public static String[] getMonths(final boolean shortened) { 
308 

309 if (shortened) ( 

310 return DATE FORMAT SYMBOLS.getShortMonths(); 
311 } 

312 else { 

313 return DATE FORMAT SYMBOLS.getMonths(); 

314 } 

315 

316 } 

317 

318 eS 

319 * Returns true if the supplied integer code representsa valid month. 
320 2: 

321 * @param code the code being checked for validity. 

322 2a 

323 * @return <code>true</code> if the supplied integer code represents a 
324 m valid month. 

325 */ 

326 public static boolean isValidMonthCode(final int code) { 

327 

328 switch(code) { 

329 case JANUARY: 

330 case FEBRUARY: 

331 case MARCH: 

332 case APRIL: 

333 case MAY: 


334 case JUNE: 


335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 


case JULY: 
case AUGUST: 
case SEPTEMBER: 
case OCTOBER: 
case NOVEMBER: 
case DECEMBER: 
return true; 
default: 


return false; 


/炒米 
* Returns the quarter forthe specified month. 


* 


* @param code the month code (1-12). 

x 

* @return the quarter thatthe month belongs to. 
* @throws java.lang.Illegal ArgumentException 

*/ 

public static int monthCodeToQuarter(final int code) { 


switch(code) { 
case JANUARY: 
case FEBRUARY: 
case MARCH: return 1; 
case APRIL: 
case MAY: 
case JUNE: return 2; 
case JULY: 
case AUGUST: 
case SEPTEMBER: return 3; 
case OCTOBER: 
case NOVEMBER: 


370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 


case DECEMBER: return 4; 
default: throw new IllegalArgumentException( 


"SerialDate.monthCodeToQuarter: invalid month code."); 


Jes 
* Retumsa string representing the supplied month. 

* <P> 

* The string returned isthe long form of the month name taken from the 
* default locale. 


* 


* @param month the month. 

x 

* @returna string representing the supplied month. 

* 

public static String  monthCodeToString(final int month) { 


return monthCodeToString(month, false); 


/炒米 

* Retumsa string representing the supplied month. 
* <P> 

* The string returned isthe longor short form of the month name taken 
* from the default locale. 

* 

* @param month the month. 

* @param shortened if <code>true</code> return the abbreviation of the 
3 month. 

x 

* @return a string representing the supplied month. 


* @throws java.lang.Illegal ArgumentException 


405 */ 


406 public static String  monthCodeToString(final int month, 

407 final boolean 
shortened) ( 

408 

409 // check arguments... 

410 if ('isValidMonthCode(month)) { 

411 throw new IllegalArgumentException( 

412 "SerialDate.monthCodeToString: month outside valid range."); 

413 } 

414 

415 final String[] months; 

416 

417 if (shortened) ( 

418 months = DATE FORMAT SYMBOLS.getShortMonths(); 

419 } 

420 else { 

421 months = DATE FORMAT SYMBOLS.getMonths(); 

422 } 

423 

424 return months[month - 1]; 

425 

426 } 

427 

428 ae 

429 * Converts a string to a month code. 

430 * <P> 

431 * This method will return one ofthe constants JANUARY, FEBRUARY, ... 

432 * DECEMBER that corresponds to the string. If the string is not 

433 * recognised, this method returns -1. 

434 * 

435 * (Oparams the string to parse. 

436 * 

437 * @return <code>-1</code> if the string is not parseable, the month of the 


438 m year otherwise. 


439 
440 
441 
442 


public static int stringToMonthCode(String s) 1 


final String[] shortMonthNames 


DATE FORMAT SYMBOLS.getShortMonths(); 


443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 


final String[] monthNames - DATE FORMAT SYMBOLS.getMonths(); 


int result = -1; 


s = s.trim(); 


// first try parsing the string as an integer (1-12)... 
try ( 
result - Integer.parseInt(s); 
j 
catch (NumberFormatException e) { 


// suppress 


// now search through the month names... 
if((result < 1)||(result» 12)) { 
for (int i20; i<monthNames.length; i++) { 
if (s.equals(shortMonthNames[i])) { 
result=i+ 1; 
break; 
} 
if (s.equals(monthNames[i])) { 
result=i+ 1; 
break; 


return result; 


473 


474 PUE 

475 * Returns true if the supplied integer code representsa valid 
476 * week-in-the-month, and false otherwise. 

477 * 

478 * @param code the code being checked for validity. 

479 * @return <code>true</code> if the supplied integer code represents a 
480 il valid week-in-the-month. 

481 */ 

482 public static boolean isValidWeekInMonthCode(final int code) { 
483 

484 switch(code) { 

485 case FIRST WEEK IN MONTH: 

486 case SECOND_WEEK_IN_MONTH: 

487 case THIRD_WEEK_IN_MONTH: 

488 case FOURTH_WEEK_IN_MONTH: 

489 case LAST WEEK IN MONTH: return true; 

490 default: return false; 

491 } 

492 

493 } 

494 

495 ail 

496 * Determines whether or not the specified year is a leap year. 
497 di 

498 * @param yyyy the year (inthe range 1900to 9999). 

499 2 

500 * @return <code>true</code> if the specified year is a leap year. 
501 */ 

502 public static boolean isLeap Year(final int yyyy) { 

503 

504 if((yyyy % 4) !-0)( 

505 return false; 

506 } 


507 else if ((yyyy 96400) ==0){ 


return true; 


j 
elseif((yyyy % 


100) --0)( 


return false; 


} 
else { 
return true; 
} 
} 
/炒米 


* Returns the number 
* INCLUSIVE. 
* <P> 


* Note that 1900 is n 


* 


of leap years from 1900 to the specified year 


ot a leap year. 


* @param yyyy the year (inthe range 1900to 9999). 


* 


* @return the number 
*/ 


public static int leapYearCount(final int yyyy) { 


of leap years from 1900 to the specified year. 


final int leap4 = (yyyy - 1896)/4; 
final int leap100 = (yyyy - 1800) / 100; 
final int leap400 = (yyyy  - 1600) / 400; 


return leap4 - 


/炒米 
* Returns the number 


* leap years. 


* 


leap100 + leap400; 


of the last day ofthe 


* @param month the month. 


month, taking into account 


543 
544 
545 
546 
547 
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549 
550 
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552 
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554 
555 
556 
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559 
560 
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565 
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567 
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570 
571 
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576 
577 


* @param yyyy the year (inthe range 1900to 9999). 

* 

* @return the number of the last day of the month. 

*/ 

public static int lastDayOfMonth(final int month, final int yyyy) { 


final int result = LAST DAY OF MONTH[month]; 
if (month !- FEBRUARY) ( 
return result; 
j 
else if (isLeapYear(yyyy)) { 


return result + 1; 


j 
else ( 
return result; 
} 
} 
[PE 


* Createsa new date by adding the specified number of days to the base 
* date. 

x 

* @param days the number of days to add (can be negative). 

* @param base thebase date. 

* 

* @retuma new date. 

x 

public static SerialDate addDays(final int days, final SerialDate base) { 


final int serialDayNumber = base.toSerial() + days; 


return SerialDate.createInstance(serialDayNumber); 


1) 


[ee 
* Createsa new date by adding the specified number of months to 
* date. 

* <P> 

* Jf the base date is close to the end of the month, the day on the 
* may be adjusted slightly: 31 May+1 month = 30 June. 

* 

* @param months the number of months to add (can be negative). 
* @param base the base date. 

* 

* @retuma new date. 

i 

public static SerialDate addMonths(final int months, 


the base 


result 


final SerialDate base) { 


final int yy = (12 * base.getY YYY() + base.getMonth() + months - 1) 


/ 12; 


final int mm = (12 * base.getYYY Y() + base.getMonth() + months - 


% 12 + 1; 
final int dd = Math.min( 
base.getDayOfMonth(), SerialDate.lastDayOfMonth(mm, 
); 


return SerialDate.createInstance(dd, mm, yy); 


[ee 
* Createsa new date by adding the specified number of years to 
* date. 

* 
* @param years the number of years to add (can be negative). 
* @param base the base date. 


* 


* @return A new date. 


yy) 


the base 


612 */ 


613 public static SerialDate addYears(final int years, final SerialDate base) ( 
614 
615 final int baseY = base.getY Y YY (); 
616 final int baseM - base.getMonth(); 
617 final int baseD = base.getDayOfMonth(); 
618 
619 final int targetY = baseY + years; 
620 final int targetD = Math.min( 
621 baseD, SerialDate.lastDayOfMonth(baseM, targetY) 
622 y 
623 
624 return SerialDate.createInstance(targetD, baseM, targetY); 
625 
626 } 
627 
628 ine 
629 * Returns the latest date that falls onthe specified day-of-the-week and 
630 *is BEFORE thebase date. 
631 2 
632 * @param targetWeekday a code for the target  day-of-the-week. 
633 * @param base the base date. 
634 2a 
635 * @retum the latest date that falls onthe specified day-of-the-week and 
636 di is BEFORE the base date. 
637 x 
638 public static SerialDate getPreviousDayOfWeek(final int targetWeekday, 
639 
final SerialDate base) { 
640 
641 // check arguments... 
642 if (ISerialDate.isValidWeekdayCode(targetWeekday)) { 
643 throw new IllegalArgumentException( 
644 "Invalid day-of-the-week code." 


645 y 


673 


// find the date... 
final int adjust; 
final int baseDOW - base.getDayOfWeek(); 
if (baseDOW >  targetWeekday) { 
adjust = Math.min(0, targetWeekday - baseDOW); 
} 
else { 
adjust - -7 + Math.max(0, targetWeekday - baseDOW); 


return SerialDate.addDays(adjust, base); 


pee 
* Returns the earliest date that falls on the specified day-of-the-week 

* and is AFTER the base date. 

* 

* @param targetWeekday a code for the target  day-of-the-week. 

* @param base the base date. 

* 

* @return the earliest date that falls on the specified day-of-the-week 

di and is AFTER the base date. 

*/ 

public static SerialDate getFollowingDayOfWeek(final int targetWeekday, 


final SerialDate base) ( 


674 
675 
676 
677 
678 
679 


// check arguments... 
if (ISerialDate.isValidWeekdayCode(targetWeekday)) { 
throw new IllegalArgumentException( 


"Invalid day-of-the-week code." 


706 


// find the date... 
final int adjust; 
final int baseDOW - base.getDayOfWeek(); 
if (baseDOW >  targetWeekday) { 
adjust= 7+ Math.min(0, targetWeekday - baseDOW); 
} 
else { 
adjust = Math.max(0, targetWeekday - baseDOW); 


return SerialDate.addDays(adjust, base); 


Jes 
* Returns the date that falls onthe specified day-of-the-week and is 
* CLOSEST to thebase date. 

* 

* @param targetDOW a code for the target day-of-the-week. 

* @param base the base date. 

* 

* @return the date that falls onthe specified day-of-the-week and is 
si CLOSEST to the base date. 

i 

public static SerialDate getNearestDayOfWeek(final int targetDOW, 


final SerialDate base) { 


707 
708 
709 
710 
711 
712 
713 


// check arguments... 
if (ISerialDate.isValidWeekdayCode(targetDOW)) { 
throw new IllegalArgumentException( 


"Invalid day-of-the-week code." 


// find the date... 
final int baseDOW - base.getDayOfWeek(); 


int adjust = -Math.abs(targetDOW - baseDOW); 


if (adjust >= 4) { 
adjust= 7 - adjust; 
} 
if (adjust <= -4)( 
adjust= 7 + adjust; 
} 
return SerialDate.addDays(adjust, base); 


[RK 


* Rolls the date forward to the last day of the month. 


* 


* @param base the base date. 


* 


* @returna new serial date. 
*/ 


public SerialDate getEndOfCurrentMonth(final SerialDate base) { 


final int last = SerialDate.lastDayOfMonth( 
base.getMonth(), base.getY YY Y() 


Ji 


return SerialDate.createInstance(last, base.getMonth(), base.getY Y Y Y()); 


/炒米 


* Retumsa string corresponding to the week-in-the-month code. 


* <P> 


* Need to find a better approach. 


* 


* @param count aninteger code representing 


* 


the week-in-the-month. 


749 * @retuma string corresponding to the week-in-the-month code. 
750 sii 


751 public static String weekInMonthToString(final int count) { 

752 

753 switch (count) { 

754 case SerialDate.FIRST_WEEK_IN_MONTH : return "First"; 
755 case SerialDate.SECOND WEEK IN MONTH : return "Second"; 
756 case SerialDate. THIRD WEEK IN MONTH : return "Third"; 
757 case SerialDate.FOURTH WEEK IN MONTH: return "Fourth"; 
758 case SerialDate. LAST WEEK IN MONTH: return "Last"; 
759 default 

760 return "SerialDate.weekInMonthToString(): invalid code."; 
761 } 

762 

763 } 

764 

765 ie 

766 * Retumsa string representing the supplied  'relative'. 

767 * <P> 

768 * Need to find a better approach. 

769 T 

770 * @param relative a constant representing the 'relative'. 

771 di 

772 * @retuma string representing the supplied ‘relative. 

773 ui 

774 public static String relativeToString(final int relative) { 

775 

776 switch (relative) { 

777 case SerialDate.PRECEDING : return "Preceding"; 

778 case SerialDate. NEAREST  : return. "Nearest"; 

779 case SerialDate.FOLLOWING : return "Following"; 

780 default :return "ERROR  :Relative To String"; 
781 } 

782 


783 } 


784 


785 re 

786 * Factory method that returns an instance of some concrete subclass of 

787 * {@link SerialDate}. 

788 * 

789 * @param day the day (1-31). 

790 * (y param month the month (1-12). 

791 * @param yyyy the year (inthe range 1900to 9999). 

792 * 

793 * @return An instance of {@link SerialDate}. 

794 cali 

795 public static SerialDate createInstance(final int day, final int month, 

796 final int 
yyyy) { 

797 return new SpreadsheetDate(day, month, yyyy); 

798 } 

799 

800 JEN 

801 * Factory method that returns an instance of some concrete subclass of 

802 * {@link SerialDate]. 

803 = 

804 * @param serial the serial number for the day (1 January 1900= 2). 

805 2a 

806 *(gretuma instance of SerialDate. 

807 ui 

808 public static SerialDate createInstance(final int serial) { 

809 return new SpreadsheetDate(serial); 

810 } 

811 

812 oi 

813 * Factory method that returns an instance of a subclass of SerialDate. 

814 = 

815 * @param date A Java date object. 

816 ii 


817 * @returma instance of SerialDate. 


818 */ 


819 public static SerialDate createInstance(final java.util.Date date) { 
820 
821 final GregorianCalendar calendar = new GregorianCalendar(); 
822 calendar.setTime(date); 
823 return new SpreadsheetDate(calendar.get(Calendar.DATE), 
824 
calendar.get(Calendar. MONTH) + 1, 
825 
calendar.get(Calendar. YEAR)); 
826 
827 } 
828 
829 asi 
830 * Returns the serial number for the date, where 1 January 1900 = 2 (this 
831 * corresponds, almost, to the numbering system used in Microsoft Excel for 
832 * Windows and Lotus 1-2-3). 
833 * 
834 * @return the serial number for the date. 
835 */ 
836 public abstract int toSerial(); 
837 
838 ie 
839 * Retumsa java.util.Date. Since java.util.Date has more precision than 
840 * SerialDate, we need to define a convention for the 'time of day’. 
841 d 
842 * @return this as <code>java.util.Date</code>. 
843 *7 
844 public abstract java.util.Date toDate(); 
845 
846 pev 
847 * Retumsa description of the date. 
848 * 
849 * @returna description of the date. 


850 E 


851 
852 
853 
854 
855 
856 
857 
858 
859 
860 
861 
862 
863 
864 
865 
866 
867 
868 
869 
870 


public String getDescription() { 


return this.description; 


Jes 
* Sets the description for the date. 

* 

* @param description the new description for the date. 
*/ 

public void  setDescription(final String description) { 


this.description = description; 


/炒米 


* Converts the date to a string. 
x 
* @return a string representation of the date. 
*/ 
public String toString() { 
return getDayOfMonth() + 


SerialDate.monthCodeToString(getMonth()) 


871 
872 
873 
874 
875 
876 
877 
878 
879 
880 
881 
882 
883 
884 


+"-" + get YYYY(); 


/炒米 


* Returns the year (assume a valid range of 1900 to 9999). 


* 


* @retum the year. 
*/ 
public abstract int getYYYY(); 


[PE 


* Returns the month (January = 1, February = 2, March= 3). 


* 


* @return the month of the year. 


885 
886 
887 
888 
889 
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892 
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898 
899 
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912 
913 
914 
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917 
918 
919 


*/ 
public abstract int getMonth(); 


[PE 


* Returns the day of the month. 


x 

* @return the day of the month. 

*/ 

public abstract int getDayOfMonth(); 


JEX 


* Returns the day of the week. 

* 

* @return the day of the week. 

ui 

public abstract int getDayOfWeek(); 


/炒米 

* Returns the difference (in days) between this date and the specified 
* 'other' date. 

* <P> 

* The result is positive if this date is after the 'other' date and 

* negative if it is before the 'other' date. 


* 


* @param other the date being compared to. 


* 
* @return the difference between this and the other date. 
*/ 


public abstract int compare(SerialDate other); 


/炒米 
* Returns true if this SerialDate represents the same date as the 


* specified SerialDate. 


* 


* @param other the date being compared to. 


920 * 


921 * @return <code>true</code> if this SerialDate represents the same date as 
922 di the specified SerialDate. 

923 si 

924 public abstract boolean isOn(SerialDate other); 

925 

926 prt 

927 * Returns true if this SerialDate represents an earlier date compared to 
928 * the specified SerialDate. 

929 = 

930 * @param other The date being compared to. 

931 di 

932 * @return <code>true</code> if this SerialDate represents an earlier date 
933 "m compared to the specified  SerialDate. 

934 +] 

935 public abstract boolean isBefore(SerialDate other); 

936 

937 [e* 

938 * Returns true if this SerialDate represents the same date as the 

939 * specified SerialDate. 

940 * 

941 * @param other the date being compared to. 

942 2a 

943 * @return <code>true<code> if this SerialDate represents the same date 
944 di as the specified SerialDate. 

945 * 

946 public abstract boolean isOnOrBefore(SerialDate other); 

947 

948 pee 

949 * Returns true if this SerialDate represents the same date as the 

950 * specified SerialDate. 

951 

952 * @param other the date being compared to. 

953 si 


954 * @return <code>true</code> if this SerialDate represents the same date 


955 
956 
957 
958 
959 
960 
961 
962 
963 
964 
965 
966 
967 
968 
969 
970 
971 
972 
973 
974 
975 
976 
977 
978 
979 
980 
981 
982 
983 
984 
985 
986 
987 
988 
989 


2i as the specified  SerialDate. 
gi 
public abstract boolean isAfter(SerialDate other); 


[PE 
* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other the date being compared to. 

x 

* @return <code>true</code> if this SerialDate represents the same date 
id as the specified SerialDate. 

gi 

public abstract boolean isOnOrAfter(SerialDate other); 


Jes 
* Returns <code>true</code> if this {@link SerialDate} is within the 

* specified range (INCLUSIVE). The date orderofdiand  d2 is not 
* important. 

* 

* @param dl a boundary date for the range. 

* @param d2 the other boundary date for the range. 

* 

* @return A boolean. 

*/ 

public abstract boolean isInRange(SerialDate d1, SerialDate d2); 


[ee 
* Returns <code>true</code> if this {@link SerialDate} is within the 
* specified range (caller specifies whether or not the end-points are 
* included). The date order of dl and d2 is not important. 

* 
* @param di aboundary datefor the range. 
* @param d2 the otherboundary date for the range. 


* @param include acode that controls whether or not the start and end 


990 È dates are included in the range. 
991 se 


992 * @return A boolean. 

993 */ 

994 public abstract boolean isInRange(SerialDate d1, SerialDate d2, 

995 int include); 
996 

997 [ER 

998 * Returns the latest date that falls onthe specified day-of-the-week and 
999 * is BEFORE this date. 

1000 * 

1001 * @param targetDOW a codefor the target day-of-the-week. 

1002 di 

1003 * @return the latest date that falls on the specified day-of-the-week and 
1004 * is BEFORE this date. 

1005 ui 

1006 public SerialDate getPreviousDayOfWeek(final int targetDOW) { 
1007 return getPreviousDayOfWeek(targetDOW, this); 

1008 } 

1009 

1010 pre 

1011 * Returns the earliest date that falls on the specified  day-of-the-week 
1012 * and is AFTER this date. 

1013 i 

1014 * @param targetDOW a code for the target day-of-the-week. 

1015 ia 

1016 * @return the earliest date that falls on the specified day-of-the-week 
1017 d and is AFTER this date. 

1018 */ 

1019 public SerialDate getFollowingDayOfWeek(final int targetDOW) { 
1020 return getFollowingDayOfWeek(targetDOW, this); 

1021 } 

1022 

1023 P 


1024 * Returns the nearest date that falls on the specified d ay-of-the-week. 


1025 È 


1026 * @param targetDOW a code for the target day-of-the-week. 

1027 * 

1028 * @return the nearest date that falls on the specified day-of-the-week. 

1029 */ 

1030 public SerialDate getNearestDayOfWeek(final int targetDOW) { 

1031 return getNearestDayOfWeek(targetDOW, this); 

1032 } 

1033 

1034 } 

代码 清单 B-2 SerialDateTest.java 

1 Nias 

* JCommon:a free general purpose class library for the Java(tm) platform 

3 * 

4 * 

5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

6 * 

7 *ProjectInfo: http://www.jfree.org/jcommon/index.html 

8 + 

9 * This library is free software; you can redistribute it and/or modi fy it 

10 *underthe terms of the GNU Lesser General Public License as published by 

11 *the Free Software Foundation; either version 2.1 of the License, or 

12 *(atyouroption) any later version. 

13 * 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied ^ warranty of 
MERCHANTABILITY 

16 *orFITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 

17 * License for more details. 

18 * 

19 * You should havereceiveda copy of the GNU Lesser General Public 


20 * License along with this library; if not, write tothe Free Software 
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
22 * USA. 

237 5 

24 *[Java isa trademark orregistered trademark of Sun Microsystems, Inc. 
25 * inthe United States and other countries.] 

26 * 

De eee eee oe 

28 * SerialDateTests.java 

DO ie ape eee ree 

30 * (C) Copyright 2001-2005, by Object Refinery Limited. 

SI 党 

32 * Original Author: David Gilbert (for Object Refinery Limited); 
33 * Contributor(s): -; 

34 * 

35 * $Id: SerialDateTests.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 
36 * 

37 * Changes 

38 * --—- 

39 * 15-Nov-2001 : Version 1 (DG); 

40 * 25-Jun-2002 : Removed unnecessary import (DG); 

41 * 24-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

42 * 13-Mar-2003 : Added serialization test (DG); 

43 * 05-Jan-2005 : Added test for bug report 1096282 (DG); 

44 * 

45 */ 

46 

47 package org.jfree.date.junit; 

48 

49 import java.io.ByteArrayInputStream; 

50 import java.io. ByteArrayOutputStream; 

51 import java.io.ObjectInput; 

52 import java.io.ObjectInputStream; 

53 import java.io.ObjectOutput; 

54 import java.io.ObjectOutputStream; 


55 

56 import junit.framework.Test; 

57 import junit.framework.TestCase; 

58 import junit.framework.TestSuite; 

59 

60 import org.jfree.date.MonthConstants; 

61 import org.jfree.date.SerialDate; 

62 

63 /** 

64 *Some JUnit tests for the {@link SerialDate} class. 
65 */ 

66 public class SerialDateTests extends TestCase { 
67 


68 /** Date representing November 9. */ 

69 private SerialDate nov9Y 2001; 

70 

71 i 

72 * Creates a new test case. 

73 * 

74 * @param name the name. 

75 | 

76 public SerialDateTests(final String name) { 
77 super(name); 

78 } 

79 

80 MP 

81 * Returns a test suite forthe JUnit test runner. 
82 * 

83 * @return The test suite. 

84 a 

85 public static Test suite() { 

86 return new TestSuite(SerialDateTests.class); 
87 } 

88 


89 [es 


90 * Problem set up. 


91 ay 

92 protected void setUp() 1 

93 this.nov9Y 2001 - SerialDate.createInstance(9, MonthConstants. NOVEMBER, 
2001); 

94 } 

95 

96 pes 

97 * 9 Nov 2001 plustwo months should be 9Jan 2002. 

98 gi 

99 public void testAddMonthsTo9Nov2001() { 

100 final SerialDate jan9Y2002 = SerialDate.addMonths(2, this.nov9Y 2001); 

101 final SerialDate answer = SerialDate.createInstance(9, 1, 2002); 

102 assertEquals(answer, jan9Y 2002); 

103 } 

104 

105 ire 

106 * A test case fora reported bug, now fixed. 

107 x 

108 public void  testAddMonths To5Oct2003() { 

109 final SerialDate dl =  SerialDate.createInstance(5, 
MonthConstants. OCTOBER,2003); 

110 final SerialDate d2 =  SerialDate.addMonths(2, d1); 

111 assertEquals(d2, SerialDate.createInstance(5, 
MonthConstants. DECEMBER, 2003)); 

112 } 

113 

114 [es 

115 * A testcase fora reported bug, now fixed. 

116 ui 

117 public void testAddMonthsTo1Jan2003() { 

118 final SerialDate dl =  SerialDate.createInstance(1, 
MonthConstants. JANUARY, 2003); 

119 final SerialDate d2 =  SerialDate.addMonths(0, d1); 


120 assertEquals(d2, d1); 
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155 


[ee 
* Monday preceding Friday 9 November 2001 should be 5 November. 
di 

public void testMondayPrecedingFriday9Nov2001() { 

SerialDate mondayBefore = SerialDate.getPreviousDayOfWeek( 
SerialDate MONDAY, this.nov9Y2001 
» 
assertEquals(5, mondayBefore.getDayOfMonth()); 


Jes 
* Monday following Friday 9 November 2001 should be 12 November. 
ui 

public void testMondayFollowingFriday9Nov2001() { 

SerialDate mondayAfter = SerialDate.getFollowingDayOfWeek( 
SerialDate MONDAY, this.nov9Y2001 

); 

assertEquals(12, mondayAfter.getDayOfMonth()); 


[ee 
* Monday nearest Friday 9 November 2001 should be 12 November. 
S 

public void  testMondayNearestFriday9Nov2001() ( 

SerialDate mondayNearest = SerialDate.getNearestDayOfWeek( 
SerialDate MONDAY, this.nov9Y 2001 

); 

assertEquals(12, mondayNearest.getDayOfMonth()); 


[RK 


* The Monday nearest to22nd January 1970 falls on the 19th. 
i 


156 
157 


158 


159 
160 
161 
162 
163 


164 
165 
166 
167 
168 


public void testMondayNearest22Jan1970() { 
SerialDate jan22Y 1970 - SerialDate.createInstance 
(22, MonthConstants.JANUARY, 1970); 
SerialDate mondayNearest=SerialDate.getNearestDayOfWeek 
(SerialDate MONDAY, jan22Y1970); 
assertEquals(19, mondayNearest.getDayOfMonth()); 


pee 
* Problem that the conversion of days to strings returns the right result. 
* Actually, this 

* result depends on the Locale so this test needs to be modified. 

i 

public void testWeekdayCodeToString() { 


final String test 


SerialDate.weekdayCodeToString(SerialDate.S ATURDAY); 


169 
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185 


assertEquals(" Saturday", test); 


[ee 

* Test the conversion of a string to a weekday. Note that this test will 
fail if the 

* default locale doesn't use English weekday names...devise a better test! 

* 

public void testStringToWeekday() { 


int weekday =  SerialDate.stringl'oWeekdayCode(" Wednesday"); 
assertEquals(SerialDate. WEDNESDAY, weekday); 


weekday = SerialDate.stringToWeekdayCode(" Wednesday "); 
assertEquals(SerialDate. WEDNESDAY, weekday); 


weekday = SerialDate.stringToWeekdayCode("Wed"); 


186 assertEquals(SerialDate. WEDNESDAY, weekday); 
187 


188 } 

189 

190 y 

191 * Test the conversion ofastringto a month. Note that this test will 

fail if the 

192 * default locale doesn't use English month names...devise a better test! 

193 */ 

194 public void testStringToMonthCode() { 

195 

196 int m = SerialDate.stringl'oMonthCode(" January"); 

197 assertEquals(MonthConstants.J ANU A RY, m); 

198 

199 m = SerialDate.stringToMonthCode(" January "); 

200 assertEquals(MonthConstants.JANUARY, m); 

201 

202 m = SerialDate.stringToMonthCode("Jan"); 

203 assertEquals(MonthConstants.JANUARY, m); 

204 

205 } 

206 

207 ail 

208 * Tests the conversion of a month code toa string. 

209 i 

210 public void  testMonthCodeToStringCode() { 

211 

212 final String test 
SerialDate.monthCodeToString(MonthConstants. DECEMBER); 

213 assertEquals(" December", test); 

214 

215 } 

216 

217 PE 


218 * 1900 is not a leap year. 
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*/ 


public void testIsNotLeapYear1900() { 
assert True(!SerialDate.isLeap Year(1900)); 


[PE 


*2000isa leap year. 


2 


public void testIsLeapYear2000() { 
assert True(SerialDate.isLeap Year(2000)); 


/** 
* The number 
*/ 


of leap years from 1900  up-to-and-including 1899 is 


public void testLeapYearCount1899() { 
assertEquals(SerialDate.leapYearCount(1899), 0); 


/炒米 
The number 
*/ 


of leap years from 1900  up-to-and-including 1903 is 


public void testLeapYearCount1903() { 
assertEquals(SerialDate.leapYearCount(1903), 0); 


/炒米 


The number 


of leap years from 1900  up-to-and-including 1904 is 


public void testLeapYearCount1904() { 
assertEquals(SerialDate.leap YearCount(1904), 1); 


[PE 


* The number 


of leap years from 1900  up-to-and-including 1999 is 


24. 
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*/ 
public void testLeapYearCount1999() { 
assertEquals(SerialDate.leap YearCount(1999), 24); 


Jes 
* The number ofleap years from 1900  up-to-and-including 2000is 25. 
*/ 
public void testLeapYearCount2000() { 

assertEquals(SerialDate.leap YearCount(2000), 25); 


/[** 
* Serialize an instance, restore it, and check for equality. 
* 


public void testSerialization() { 


SerialDate dl =  SerialDate.createInstance(15, 4, 2000); 
SerialDate d2 = null; 


try { 
ByteArrayOutputStream buffer = new ByteArrayOutputStream(); 
ObjectOutput out = new ObjectOutputStream(buffer); 
out. writeObject(d1); 


out.close(); 


ObjectInput in= new ObjectInputStream 
(new 
ByteArrayInputStream(buffer.toByteA rray())); 
d2 = (SerialDate) in.readObject(); 
in.close(); 
j 
catch (Exception e) { 
System.out.println(e.toString()); 


assertEquals(d1, d2); 


/炒米 


* Atest for bug report 1096282 (now fixed). 


*/ 


public void test1096282() { 


SerialDate d = 


SerialDate.createInstance(29, 2, 2004); 


d = SerialDate.addYears(1, d); 
SerialDate expected = SerialDate.createInstance(28, 2, 2005); 


assert True(d.isOn(expected)); 


[PE 
* Miscellaneous tests 
*/ 


for the addMonths() method. 


public void testAddMonths() { 


SerialDate d1 = 


SerialDate d2 = 


SerialDate.createInstance(31, 5, 2004); 


SerialDate.addMonths(1, d1); 


assertEquals(30, d2.getDayOfMonth()); 


assertEquals(6, 


d2.getMonth()); 


assertEquals(2004, d2.getY Y Y Y ()); 


SerialDate d3 = 


assertEquals(31, 


assertEquals(7, 


SerialDate.addMonths(2, d1); 
d3.getDayOfMonth()); 
d3.getMonth()); 


assertEquals(2004, d3.getY Y Y Y ()); 


SerialDate d4 = 


SerialDate.addMonths(1, SerialDate.addMonths(1, d1)); 


assertEquals(30, d4.getDayOfMonth()); 


assertEquals(7, 


d4.getMonth()); 


assertEquals(2004, | d4.getY Y Y Y()); 


322 } 
代码 清单 B-3 MonthConstants.java 


1 7" 
* JCommon:a free general purpose class library for the Java(tm) platform 

3 * 

4 * 

5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

6 * 

7 *ProjectInfo: http://www.jfree.org/jcommon/index.html 

8 * 

9 *Thislibrary is free software; you can redistribute it and/or modi fy it 

10 *underthe terms of the GNU Lesser General Public License as published by 

11 * the Free Software Foundation; either version 2.1 of the License, or 

12 *(atyouroption) any later version. 

13 * 

14 * This library is distributed in the hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied ^ warranty of 
MERCHANTABILITY 

16 *orFITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 

17 * License for more details. 

18 * 

19 * You should havereceiveda copy of the GNU Lesser General Public 

20 * License along with this library; if not, write tothe Free Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 

22 * USA. 

23 ^ 

24 *[Java isa trademark orregistered trademark of Sun Microsystems, Inc. 

25 * jin the United States and other countries.] 

26 * 

FP E eria 

28 * MonthConstants.java 


pe POTE eRe eee 
30 * (C) Copyright 2002, 2003, by Object Refinery Limited. 


Sl. 

32 * Original Author: David Gilbert (for Object Refinery Limited); 
33 * Contributor(s): -; 

34 * 


35 * $Id: MonthConstants.java,v 1.4 2005/11/16 15:58:40 taqua Exp $ 

36 * 

37 * Changes 

38 * -- 

39 * 29-May-2002 : Version 1 (code moved from SerialDate class) (DG); 

40 * 

41 */ 

42 

43 package org.jfree.date; 

44 

45 /** 

46 * Useful constants for months. Note that these are NOT equivalent to the 

47 * constants defined by java.util.Calendar (where JANUARY-0 and 
DECEMBER-11). 


48 * <P> 

49 * Used by the SerialDate and RegularTimePeriod classes. 
50. * 

51 * @author David Gilbert 

Bg cM 

53 public interface MonthConstants { 

54 

55 /** Constant for January. */ 

56 public static final int JANUARY = 1; 
57 

58 /** Constant for February. */ 

59 public static final int FEBRUARY = 2; 
60 

61 /** Constant for March. */ 


62 public static finalint MARCH =3; 


63 


64 /** Constant for April. */ 

65 public static final int APRIL =4; 

66 

67 /** Constant for May. */ 

68 public static final int MAY = 5; 

69 

70 /** Constant for June. */ 

71 public static final int JUNE= 6; 

72 

73 /** Constant forJuly. */ 

74 public static final int JULY= 7; 

75 

76 /** Constant for August. */ 

77 public static finalint AUGUST =8; 
78 

79 /** Constant for September. */ 

80 public static final int SEPTEMBER = 9; 
81 

82 /** Constant for October. */ 

83 public static final int OCTOBER = 10; 
84 

85 /** Constant for November. */ 

86 public static final int NOVEMBER = 11; 
87 

88 /** Constant for December. */ 

89 public static final int DECEMBER = 12; 
90 

91} 


代码 清单 B-4 BobsSerialDateTest.java 
1 package org.jfree.date.junit; 

2 

3 import junit.framework.TestCase; 

4 import org.jfree.date.*; 


5 import static org.jfree.date.SerialDate.*; 


6 


7 import java.util.*; 


8 


9 public class BobsSerialDateTest extends TestCase { 


10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 


public void testIsValidWeekdayCode() throws Exception { 
for (int day =1;day <=7; day++) 
assert True(is ValidWeekdayCode(day)); 
assertFalse(is ValidWeekdayCode(0)); 
assertFalse(is ValidWeekdayCode(8)); 


public void testStringToWeekdayCode() throws Exception { 


assertEquals(-1, string ToWeekdayCode("Hello")); 


assertEquals(MONDAY, string ToWeekdayCode("Monday")); 
assertEquals(MONDAY,  stringToWeekdayCode("Mon")); 


23 //todo assertEquals(MONDAY, string ToWeekdayCode("monday")); 


24 // 
25 // 
26 
27 
28 
29 // 
30 // 
31 // 
32 // 
33 
34 
35 
36 // 
37 // 
38 // 
39 
40 


assertEquals(MONDAY, string ToWeekdayCode("MONDAY'")); 
assertEquals(MONDAY, stringToWeekdayCode("mon")); 


assertEquals(TUESDAY, stringToWeekdayCode("Tuesday")); 
assertEquals(TUESDAY, stringToWeekdayCode("Tue")); 
assertEquals(TUESDAY, string To WeekdayCode("tuesday")); 
assertEquals(TUESDAY,stringToWeekdayCode("TUESDAY")); 
assertEquals(TUESDAY, stringToWeekdayCode("tue")); 
assertEquals(TUESDAY, stringToWeekdayCode("tues")); 


assertEquals(WEDNESDAY, stringToWeekdayCode("Wednesday")); 
assertEquals(WEDNESDAY, stringToWeekdayCode("Wed")); 
assertEquals(WEDNESDAY,stringToWeekdayCode("wednesday")); 
assertEquals(WEDNESDAY, string ToWeekdayCode("WEDNESDAY")); 
assertEquals(WEDNESDAY, stringToWeekdayCode("wed")); 


assertEquals(THURSDAY, stringToWeekdayCode("Thursday")); 


41 assertEquals( THURSDAY, stringToWeekdayCode("Thu")); 
42 // assertEquals(THURSDAY,stringToWeekdayCode("thursday")); 
43 // assertEquals(THURSDAY,;stringl'oWeekdayCode(" THURSDAY ")); 
44 // assertEquals(THURSDAY, stringToWeekdayCode("thu")); 

45 // assertEquals(THURSDAY, stringToWeekdayCode("thurs")); 

46 

47 assertEquals(FRIDAY, stringToWeekdayCode("Friday")); 

48 assertEquals(FRIDAY, stringToWeekdayCode("Fri")); 

49 // assertEquals(FRIDAY, string ToWeekdayCode("friday")); 

50 // assertEquals(FRIDAY, string ToWeekdayCode("FRIDAY")); 

51 // assertEquals(FRIDAY, stringToWeekdayCode("fri")); 

52 

53 assertEquals(SATURDAY, | stringToWeekdayCode("Saturday")); 
54 assertEquals(SATURDAY, | stringToWeekdayCode("Sat")); 

55 // assertEquals(SATURDAY;, string ToWeekdayCode("saturday")); 
56 // assertEquals(SATURDAY;, string ToWeekdayCode("SATURDAY")); 
57 // assertEquals(SATURDAY, stringToWeekdayCode("sat")); 

58 

59 assertEquals(SUNDAY, stringToWeekdayCode("Sunday")); 

60 assertEquals(SUNDAY, stringToWeekdayCode("Sun")); 

61 // assertEquals(SUNDAY, string ToWeekdayCode("sunday")); 

62 // assertEquals(SUNDAY, string ToWeekdayCode("SUNDAY")); 

63 // assertEquals(SUNDAY, stringToWeekdayCode("sun")); 


64 } 

65 

66 public void testWeekdayCodeToString() throws Exception { 
67 assertEquals("Sunday", weekdayCodeToString(SUNDAY)); 
68 assertEquals("Monday", weekdayCodeToString(MONDAY)); 
69 assertEquals(" Tuesday", weekdayCodeToString( TUESDAY)); 
70 assertEquals("Wednesday", weekdayCodeToString(WEDNESDAY)); 
71 assertEquals(" Thursday", weekdayCodeToString( THURSDAY )); 
72 assertEquals("Friday", weekdayCodeToString(FRIDAY)); 

73 assertEquals(" Saturday", weekdayCodeToString(SATURDAY)); 
74 } 


75 


76 
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public void testis ValidMonthCode() throws Exception { 


for (inti= 1; i <= 12; i++) 

assert True(is ValidMonthCode(i)); 
assertFalse(is ValidMonthCode(0)); 
assertFalse(is ValidMonthCode(13)); 


public void testMonthToQuarter() throws Exception { 


assertEquals(1, monthCodeToQuarter(JANUARY)); 
assertEquals(1, monthCodeToQuarter(FEBRUARY)); 
assertEquals(1, monthCodeToQuarter(MARCH)); 
assertEquals(2, monthCodeToQuarter(APRIL)); 
assertEquals(2, monthCodeToQuarter(M AY)); 
assertEquals(2, monthCodeToQuarter(JUNE)); 
assertEquals(3, monthCodeToQuarter(JULY)); 
assertEquals(3, monthCodeToQuarter( AUGUST)); 
assertEquals(3, monthCodeToQuarter(SEPTEMBER)); 
assertEquals(4, monthCodeToQuarter(OCTOBER)); 
assertEquals(4, monthCodeToQuarter(NOV EMBER)); 
assertEquals(4, monthCodeToQuarter(DECEMBER)); 


try ( 
monthCodeToQuarter(-1); 
fail("Invalid Month Code should throw exception"); 
} catch (IllegalArgumentException e) { 


} 


public void testMonthCodeToString() throws Exception { 
assertEquals("January", monthCodeToString(JANUARY)); 
assertEquals(" February", monthCodeToString(FEBRUARY)); 
assertEquals("March", monthCodeToString(MARCH)); 
assertEquals(" April", monthCodeToString( APRIL)); 
assertEquals("May", monthCodeToString(M AY)); 
assertEquals("June", monthCodeToString(JUNE)); 
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assertEquals("July", monthCodeToString(JULY)); 
assertEquals(" August", monthCodeToString( AUGUST)); 
assertEquals(" September", monthCodeToString(SEPTEMBER)); 
assertEquals("October", monthCodeToString( OCTOBER)); 
assertEquals("November", monthCodeToString(NOVEMBER)); 
assertEquals("December", monthCodeToString(DECEMBER)); 


assertEquals("Jan", monthCodeToString(JANUARY, true)); 
assertEquals("Feb", monthCodeToString(FEBRUARY, true)); 
assertEquals("Mar", monthCodeToString(MARCH,  true)); 
assertEquals(" Apr", monthCodeToString(APRIL, — true)); 
assertEquals("May", monthCodeToString(M AY, true)); 
assertEquals("Jun", monthCodeToString(JUNE, — true)); 
assertEquals("Jul", monthCodeToString(JULY,  true)); 
assertEquals(" Aug", monthCodeToString( AUGUST, true)); 
assertEquals(" Sep", monthCodeToString(SEPTEMBER, true)); 
assertEquals("Oct", monthCodeToString(OCTOBER, true)); 
assertEquals("Nov", monthCodeToString(NOVEMBER, true)); 
assertEquals("Dec", monthCodeToString( DECEMBER, true)); 


try ( 

monthCodeToString(-1); 

fail("Invalid month code should throw exception"); 
} catch (IllegalArgumentException e) { 
j 


public void testStringToMonthCode() throws Exception { 


assertEquals(JANUARY,;stringl'oMonthCode("1")); 
assertEquals(FEBRUARY, string ToMonthCode("2")); 
assertEquals(MARCH, stringToMonthCode("3")); 
assertEquals(APRIL,stringToMonthCode("4")); 
assertEquals(MAY, string ToMonthCode("5")); 
assertEquals(JUNE, string ToMonthCode("6")); 


146 assertEquals(JULY,stringToMonthCode("7")); 


147 assertEquals(AUGUST,stringToMonthCode("8")); 

148 assertEquals(SEPTEMBER, stringToMonthCode("9")); 
149 assertEquals(OCTOBER,stringToMonthCode("10")); 
150 assertEquals(NOVEMBER, string ToMonthCode("11")); 
151 assertEquals(DECEMBER,string ToMonthCode(" 12")); 
152 


153 //todo assertEquals(-1, string ToMonthCode("0")); 
154 // assertEquals(-1, stringToMonthCode("13")); 


155 

156 assertEquals(-1,stringToMonthCode("Hello")); 

157 

158 for (intm= 1;m<= 12; m++){ 

159 assertEquals(m, stringToMonthCode(monthCodeToString(m,  false))); 
160 assertEquals(m, stringToMonthCode(monthCodeToString(m,  true))); 
161 } 

162 


163 // assertEquals(1,stringToMonthCode("jan")); 
164 // assertEquals(2,stringToMonthCode("feb")); 
165 // assertEquals(3,stringToMonthCode("mar")); 
166 // assertEquals(4,stringToMonthCode("apr")); 
167 // assertEquals(5,stringToMonthCode("may")); 
168 // assertEquals(6,stringToMonthCode("jun")); 
169 // assertEquals(7,stringToMonthCode("jul")); 
170 // assertEquals(8,stringToMonthCode("aug")); 
171 // assertEquals(9,stringToMonthCode("sep")); 
172 // assertEquals(10,stringToMonthCode("oct")); 
173 // assertEquals(11,stringToMonthCode("nov")); 
174 // assertEquals(12,stringToMonthCode("dec")); 
175 

176 // assertEquals(1,stringToMonthCode("JAN")); 
177 // assertEquals(2,stringToMonthCode("FEB")); 
178 // assertEquals(3,stringloMonthCode(" MAR")); 
179 // assertEquals(4,stringToMonthCode("APR")); 
180 // assertEquals(5,stringToMonthCode("MAY")); 


assertEquals(6,stringToMonthCode("JUN")); 
assertEquals(7,stringToMonthCode("JUL")); 
assertEquals(8,stringToMonthCode("AUG")); 
assertEquals(9,stringToMonthCode("SEP")); 
assertEquals(10,stringToMonthCode("OCT")); 
assertEquals(11,stringToMonthCode("NOV")); 
assertEquals(12,stringToMonthCode("DEC")); 


assertEquals(1,stringToMonthCode("january")); 
assertEquals(2,stringToMonthCode("february")); 
assertEquals(3,stringToMonthCode("march")); 
assertEquals(4,stringToMonthCode("april")); 
assertEquals(5,stringToMonthCode("may")); 
assertEquals(6,stringToMonthCode("june")); 
assertEquals(7,stringToMonthCode("july")); 
assertEquals(8,stringToMonthCode("august")); 
assertEquals(9,stringToMonthCode("september")); 
assertEquals(10,stringToMonthCode("october")); 
assertEquals(11,stringToMonthCode("november")); 
assertEquals(12,stringToMonthCode("december")); 


assertEquals(1,stringToMonthCode("JANUARY")); 
assertEquals(2,stringToMonthCode("FEBRUARY")); 
assertEquals(3,stringToMonthCode("MAR")); 
assertEquals(4,stringToMonthCode("APRIL")); 
assertEquals(5,stringToMonthCode("MAY")); 
assertEquals(6,stringToMonthCode("JUNE")); 
assertEquals(7,stringToMonthCode("JULY")); 
assertEquals(8,stringToMonthCode("AUGUST")); 
assertEquals(9,stringToMonthCode("SEPTEMBER")); 
assertEquals(10,stringToMonthCode("OCTOBER")); 
assertEquals(11,stringToMonthCode("NOVEMBER")); 
assertEquals(12,stringToMonthCode("DECEMBER")); 
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public void testIsValidWeekInMonthCode() throws 
for (intw= 0;w«- 4;wtt) { 
assertTrue(is ValidWeekInMonthCode(w)); 
} 
assertFalse(is ValidWeekInMonthCode(5)); 


public void testIsLeapYear() throws Exception { 
assertFalse(isLeap Year(1900)); 
assertFalse(isLeap Year(1901)); 
assertFalse(isLeap Year(1902)); 
assertFalse(isLeap Year(1903)); 
assert True(isLeap Year(1904)); 
assert True(isLeap Year(1908)); 
assertFalse(isLeap Year(1955)); 
assert True(isLeap Year(1964)); 
assert True(isLeap Year(1980)); 
assert True(isLeap Year(2000)); 
assertFalse(isLeap Year(2001)); 
assertFalse(isLeap Year(2100)); 


public void testLeapYearCount() throws Exception { 
assertEquals(0, leapYearCount(1900)); 
assertEquals(0, leapYearCount(1901)); 
assertEquals(0, leapYearCount(1902)); 
assertEquals(0, leapYearCount(1903)); 
assertEquals(1, leapYearCount(1904)); 
assertEquals(1, leapYearCount(1905)); 
assertEquals(1, leapYearCount(1906)); 
assertEquals(1, leapYearCount(1907)); 
assertEquals(2, leapYearCount(1908)); 
assertEquals(24, leap YearCount(1999)); 
assertEquals(25, leap YearCount(2001)); 
assertEquals(49, leap YearCount(2101)); 


Exception { 


251 assertEquals(73, leap YearCount(2201)); 


252 assertEquals(97, leap YearCount(2301)); 

253 assertEquals(122, leapYearCount(2401)); 

254 } 

255 

256 public void testLastDayOfMonth() throws Exception { 

257 assertEquals(31, lastDayOfMonth(JANUARY, 1901)); 

258 assertEquals(28, lastDayOfMonth(FEBRUARY, . 1901)); 

259 assertEquals(31, lastDayOfMonth(MARCH, 1901)); 

260 assertEquals(30, lastDayOfMonth(APRIL, 1901)); 

261 assertEquals(31, lastDayOfMonth(MAY, 1901)); 

262 assertEquals(30, lastDayOfMonth(JUNE, 1901)); 

263 assertEquals(31, lastDayOfMonth(JULY, 1901)); 

264 assertEquals(31, lastDayOfMonth(AUGUST, 1901)); 

265 assertEquals(30, lastDayOfMonth(SEPTEMBER, 1901)); 

266 assertEquals(31, lastDayOfMonth(OCTOBER, 1901)); 

267 assertEquals(30, lastDayOfMonth(NOVEMBER, 1901)); 

268 assertEquals(31, lastDayOfMonth(DECEMBER, 1901)); 

269 assertEquals(29, lastDayOfMonth(FEBRUA RY, 1904)); 

270 } 

271 

272 public void testAddDays() throws Exception { 

273 SerialDate newYears =d(1, JANUARY, 1900); 

274 assertEquals(d(2, JANUARY, 1900), addDays(1, newYears)); 
275 assertEquals(d(1, FEBRUARY, 1900), addDays(31, new Years)); 
276 assertEquals(d(1, JANUARY, 1901), addDays(365, new Years)); 
277 assertEquals(d(31, DECEMBER, 1904), addDays(5 * 365, newY ears)); 
278 } 

279 

280 private static SpreadsheetDate d(int day, int month, int year) {return new 


SpreadsheetDate(day, month, year); 

281 

282 public void testAddMonths() throws Exception { 

283 assertEquals(d(1, FEBRUARY, 1900), addMonths(1, d(1, JANUARY, 1900))); 
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306 


assertEquals(d(28, FEBRUARY, 1900) addMonths(1, d(31, JANUARY, 


assertEquals(d(28, FEBRUARY, 1900) addMonths(1, d(30, JANUARY, 


assertEquals(d(28, FEBRUARY, 1900),  addMonths(1, d(29, JA NUARY, 


assertEquals(d(28, FEBRUARY, 1900), . addMonths(1, d(28, JANUARY, 


assertEquals(d(27, FEBRUARY, 1900),  addMonths(1, d(27, JANUARY, 


assertEquals(d(30, JUNE, 1900), addMonths(5, d(31, JANUARY, 1900))); 


assertEquals(d(30, JUNE, 1901), addMonths(17, d(31, JANUARY, 1900))); 


assertEquals(d(29, FEBRUARY, 1904), | addMonths(49, d(31, JANUARY, 


public void testAddYears() throws Exception 1 
assertEquals(d(1, JANUARY, 1901), addYears(1, d(1, JANUARY, 1900))); 
assertEquals(d(28, FEBRUARY, 1905),  addYears(1, d(29, FEBRUARY, 


assertEquals(d(28, FEBRUARY, 1905),  addYears(1, d(28, FEBRUARY, 


assertEquals(d(28, FEBRUARY, 1904), addYears(1, d(28, FEBRUARY, 


public void testGetPreviousDayOfWeek() throws Exception { 
assertEquals(d(24, FEBRUARY, 2006), | getPreviousDayOfWeek(FRIDAY, 
d(1, MARCH, 2006))); 
assertEquals(d(22, FEBRUARY, 2006), 


getPreviousDayOfWeek(WEDNESDAY, 


d(1, MARCH, 2006))); 


307 


308 


assertEquals(d(29, FEBRUARY, |. 2004), | getPreviousDayOfWeek(SUNDAY, 
d(3, MARCH, 2004))); 
assertEquals(d(29, DECEMBER, 2004), 


getPreviousDayOfWeek(WEDNESDAY, 
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2006))); 
331 
2006))); 
332 
2006))); 


d(5, JANUARY, 2005))); 


try ( 
getPreviousDayOfWeek(-1, d(1, JANUARY, 2006)); 
fail("Invalid day of week code should throw exception"); 
} catch (IllegalArgumentException e) ( 
} 


public void testGetFollowingDayOfWeek() throws Exception { 
assertEquals(d(1, JANUARY, 2005),getFollowingDayOfWeek(SATURDAY, 
d(25, DECEMBER, 2004))); 
assertEquals(d(1, JANUARY, 2005), getFollowin gDayOfWeek(SATURDAY, 
d(26, DECEMBER, 2004))); 
assertEquals(d(3, MARCH, 2004), getFollowingDayOfWeek(WEDNESDAY, 
d(28, FEBRUARY, 2004))); 


try ( 
getFollowingDayOfWeek(-1, d(1, JANUARY, 2006)); 
fail("Invalid day of week code should throw exception"); 


} catch (IllegalArgumentException e) { 
j 


public void testGetNearestDayOfWeek() throws Exception { 
assertEquals(d(16, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(16, APRIL, 


assertEquals(d(16, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(17, APRIL, 


assertEquals(d(16, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(18, APRIL, 


333 assertEquals(d(16, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(19, APRIL, 


2006))); 


334 assertEquals(d(23, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(20, APRIL, 


2006))); 


335 assertEquals(d(23, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(21, APRIL, 


2006))); 


336 assertEquals(d(23, APRIL, 2006), getNearestDayOfWeek(SUNDAY, d(22, APRIL, 


2006))); 
337 
338 //todo assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek(MONDAY, 
d(16, APRIL, 2006)); 


339 assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek(MONDAY, 
APRIL, 2006))); 

340 assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek(MONDAY, 
APRIL, 2006))); 

341 assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek(MOND AY, 


APRIL, 2006))); 


342 assertEquals(d(17, APRIL, 2006), getNearestDayOfWeek(MONDAY, 


APRIL, 2006))); 


343 assertEquals(d(24, APRIL, 2006), getNearestDayOfWeek(MONDAY, 


APRIL, 2006))); 


344 assertEquals(d(24, APRIL, 2006), getNearestDayOfWeek(MONDAY, 


APRIL, 2006))); 
345 
346 // assertEquals(d(18, APRIL, 2006), getNearestDayOfWeek(TUESDAY, 
d(16, APRIL, 2006))); 
347 // assertEquals(d(18, APRIL, 2006), getNearestDayOfWeek(TUESDAY, 
d(17, APRIL, 2006))); 
348 
assertEquals(d(18, APRIL,2006),getNearestDayOfWeek(TUESDAY,d(18,A PRIL,2006))); 
349 
assertEquals(d(18, APRIL,2006),getNearestDayOfWeek(TUESDAY,d(19,A PRIL,2006))); 
350 
assertEquals(d(18, A PRIL,2006),getNearestDayOfWeek(TUESDAY,d(20,A PRIL,2006))); 


d(17, 


d(18, 


d(19, 


d(20, 


d(21, 


d(22, 


351 
assertEquals(d(18, APRIL,2006),getNearestDayOfWeek(TUESDAY,d(21,A PRIL,2006))); 
352 
assertEquals(d(25, APRIL,2006),getNearestDayOfWeek(TUESDAY,d(22, A PRIL,2006))); 
353 
354 // assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY 
d(16, APRIL, 2006))); 
355 // assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 
d(17, APRIL, 2006))); 
356 // assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 
d(18, APRIL, 2006))); 


357 assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 
d(19, APRIL, 2006))); 

358 assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 
d(20, APRIL, 2006))); 

359 assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 
d(21, APRIL, 2006))); 

360 assertEquals(d(19, APRIL, 2006), getNearestDayOfWeek(WEDNESDAY, 


d(22, APRIL, 2006))); 
361 
362 // assertEquals(d(13, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(16, APRIL, 2006))); 
363 // assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(17, APRIL, 2006))); 
364 // assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(18, APRIL, 2006))); 
365 // assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(19, APRIL, 2006))); 


366 assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(20, APRIL, 2006))); 

367 assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 
d(21, APRIL, 2006))); 

368 assertEquals(d(20, APRIL, 2006), getNearestDayOfWeek(THURSDAY, 


d(22, APRIL, 2006))); 
369 


370// 
assertEquals(d(14, APRIL,2006),getNearestDayOfWeek(FRIDAY,d(16,A PRIL,2006))); 
371// 
assertEquals(d(14, APRIL,2006),getNearestDayOfWeek(FRIDAY,d(17,A PRIL,2006))); 
372// 
assertEquals(d(21,APRIL,2006),getNearestDayOfWeek(FRIDAY,d(18,A PRIL,2006))); 
373// 
assertEquals(d(21, A PRIL,2006),getNearestDayOfWeek(FRIDAY,d(19,A PRIL,2006))); 
374// 
assertEquals(d(21, A PRIL,2006),getNearestDayOfWeek(FRIDAY,d(20,A PRIL,2006))); 


375 assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(21, APRIL, 
2006))); 

376 assertEquals(d(21, APRIL, 2006), getNearestDayOfWeek(FRIDAY, d(22, APRIL, 
2 006))); 

377 


378 // assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(16, APRIL, 2006))); 
379 // assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(17, APRIL, 2006))); 
380 // assertEquals(d(15, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(18, APRIL, 2006))); 
381 // assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(19, APRIL, 2006))); 
382 // assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek(SA TURDAY, 
d(20, APRIL, 2006))); 
383 // assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(21, APRIL, 2006))); 
384 assertEquals(d(22, APRIL, 2006), getNearestDayOfWeek(SATURDAY, 
d(22, APRIL, 2006))); 


385 

386 try ( 

387 getNearestDayOfWeek(-1, d(1, JANUARY, 2006); 

388 fail("Invalid day of week code should throw exception"); 
389 } catch (IllegalArgumentException e) { 


390 } 


391 } 
392 
393 public void testEndOfCurrentMonth() throws Exception { 


394 SerialDate d = SerialDate.createInstance(2); 

395 assertEquals(d(31, JANUARY, 2006), d.getEndOfCurrentMonth(d(1, JANUARY, 
2006))); 

396 assertEquals(d(28, FEBRUARY,2006), d.getEndOfCurrentMonth(d(1, 
FEBRUARY,2006))); 

397 assertEquals(d(31, MARCH, 2006), d.getEndOfCurrentMonth(d(1, MARCH, 
2006))); 

398 assertEquals(d(30, APRIL, 2006), d.getEndOfCurrentMonth(d(1, APRIL, 2006))); 

399 assertEquals(d(31, MAY, 2006), d.getEndOfCurrentMonth(d(1, MAY, 2006))); 

400 assertEquals(d(30, JUNE, 2006), d.getEndOfCurrentMonth(d(1, JUNE, 2006))); 

401 assertEquals(d(31, JULY, 2006), d.getEndOfCurrentMonth(d(1, JULY, 2006))); 

402 assertEquals(d(31, AUGUST, 2006), d.getEndOfCurrentMonth(d(1, AUGUST, 
2006))); 

403 assertEquals(d(30, SEPTEMBER, 2006), d.getEndOfCurrentMonth 

(d(1, SEPTEMBER, 2006))); 

404 assertEquals(d(31, OCTOBER, 2006), d.getEndOfCurrentMonth(d(1, OCTOBER, 
2006))); 

405 assertEquals(d(30, NOVEMBER,2006), d.getEndOfCurrentMonth(d(1, 
NOVEMBER,2006))); 

406 assertEquals(d(31, _DECEMBER,2006), d.getEndOfCurrentMonth(d(1, 
DECEMBER, 2006))); 

407 assertEquals(d(29, FEBRUARY,2008), d.getEndOfCurrentMonth(d(1, 
FEBRUARY,2008))); 

408 } 

409 


410 public void testWeekInMonthToString() throws Exception { 

411 assertEquals("First",weekInMonthToString(FIRST_WEEK_IN_MONTH)); 

412 assertEquals("Second",weekInMonthToString(SECOND_WEEK_IN_MONTH)); 
413 assertEquals("Third",weekInMonthToString(THIRD_WEEK_IN_MONTH)); 
414 assertEquals("Fourth",weekInMonthToString(FOURTH_WEEK_IN_MONTH)); 
415 assertEquals("Last",weekInMonthToString(LAST_WEEK_IN_MONTH)); 

416 


417 //todo try { 

418 // weekInMonthToString(-1); 

419 // fail("Invalid week code should throw exception"); 
420 // } catch (IllegalArgumentException e) { 


421 // } 

422 } 

423 

424 public void testRelativeToString() throws Exception { 
425 assertEquals("Preceding",relativeToString(PRECEDING)); 
426 assertEquals("Nearest",relativeToString(NEAREST)); 

427 assertEquals("Following",relativeToString(FOLLOWING)); 
428 

429 //todo try { 

430 // relativeToString(-1000); 

431 // fail("Invalid relative code should throw exception"); 


432 // } catch (IllegalArgumentException e) { 


433 // } 

434 } 

435 

436 public void testCreateInstanceFromDDMMYYY() throws Exception { 
437 SerialDate date = createInstance(1, JANUARY, 1900); 

438 assertEquals(1,date.getDayOfMonth()); 

439 assertEquals(JANUARY,date.getMonth()); 

440 assertEquals(1900,date.getY Y Y Y()); 

441 assertEquals(2,date.toSerial()); 

442 } 

443 

444 public void testCreateInstanceFromSerial() throws Exception  ( 
445 assertEquals(d(1, JANUARY, 1900),createInstance(2)); 

446 assertEquals(d(1, JANUARY, 1901), createInstance(367)); 

447 } 

448 

449 public void testCreateInstanceFromJavaDate() throws Exception { 
450 assertEquals(d(1, JANUARY, 1900), 


createInstance(new GregorianCalendar(1900,0,1).getTime())); 


451 assertEquals(d(1, JANUARY, 2006), 
createInstance(new GregorianCalendar(2006,0,1).getTime())); 
452 } 
453 
454 public static void main(String[] args) { 
455 junit.textui. TestRunner.run(BobsSerialDateTest.class); 
456 } 
457 } 
代码 清单 B-5 SpreadsheetDate.java 
1 p 
* JCommon:a free general purpose class library for the Java(tm) platform 
* 
4 * 
5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
6 * 
7 * Project Info: http://www.jfree.org/jcommon/index.html 
8 * 
9 *Thislibrary is free software; you can redistribute it and/or modify it 
10 *underthe terms of the GNU Lesser General Public License as published by 
11 *the Free Software Foundation; either version 2.1 of the License, or 
12 *(atyouroption) any later version. 
is. * 
14 * This library is distributed in the hope that it will be useful, but 
15 * WITHOUT ANY WARRANTY; without even the implied ^ warranty of 
MERCHANTABILITY 
16 *orFITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 
17 * License for more details. 
18 * 
19 * You should have receiveda copy of the GNU Lesser General Public 
20 * License along with this library; if not, write tothe Free Software 
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 
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* USA. 
x 
* [Javaisa trademark or registered trademark of Sun Microsystems, Inc. 


* in the United States and other countries. ] 


* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 
* 

* Original Author: David Gilbert (for Object Refinery Limited); 

* Contributor(s): -; 


* 


* $Id: SpreadsheetDate.java,v 1.8 2005/11/03 09:25:39 mungady Exp $ 


* 


* Changes 

* 11-Oct-2001 : Version 1 (DG); 

* 05-Nov-2001 : Added getDescription() and setDescription() methods (DG); 

* 12-Nov-2001 : Changed name from ExcelDate.java to SpreadsheetDate.java (DG); 


= Fixed a bug in calculating day, month and year from serial 
站 number (DG); 

* 24-Jan-2002 : Fixed a bug in calculating the serial number from the day, 

m month and year. Thanks to Trevor Hills for the report 
* 29-May-2002 : Added equals(Object) method (SourceForge ID 558850) (DG); 


* 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 
* 13-Mar-2003 : Implemented Serializable (DG); 

* 04-Sep-2003 : Completed isInRange() methods (DG); 

* 05-Sep-2003 : Implemented Comparable (DG); 

* 21-Oct-2003 : Added hashCode() method (DG); 


* 


*/ 


55 package org.jfree.date; 


56 


57 import java.util.Calendar; 


58 import java.util.Date; 


59 
60 /** 
61 *Represents adate usingan integer, in a similar fashion to the 


62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 


* implementation in Microsoft Excel. Therange of dates supported is 

* 1-Jan-1900 to 31-Dec-9999. 

* <P> 

* Be aware that there is a deliberate bug in Excel that recognis es the year 

* 1900 asa leap year when in fact itis not a leap year. You can find more 

* information on the Microsoft website in article Q181370: 

* <P> 

* http://support.microsoft.com/support/kb/articles/Q181/3/70.asp 

* <P> 

* Excel uses the convention that 1-Jan-1900 - 1. This class uses the 

* convention 1-Jan-1900 - 2. 

* The result isthat the day number in this class will be different to the 
* Excel figure for January and February 1900...but then Exce | adds in an extra 
* day (29-Feb-1900 which does not actually exist!) and from that point forward 
* the day numbers will match. 

* 

* @author David Gilbert 

i 


80 public class SpreadsheetDate extends SerialDate  ( 
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/** For serialization. */ 


private static final long serialVersionUID = -2039586705374454461L; 


[PE 

* The day number (1-Jan-1900 = 2, 2-Jan-1900 =3,..., 31-Dec-9999 = 
* 2958465). 

*/ 


private int serial; 
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98 

99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 


/** The day of the month (1to 28,29, 300r 31depending onthe month). 


private int day; 


/** The month of the year (1 to 12). */ 


private int month; 


/** The year (1900 to 9999). */ 


private int year; 


/** An optional description forthe date. */ 


private String description; 


/炒米 


* Createsa new date instance. 

* 

* @param day the day (in the range 1to —. 28/29/30/31). 

* @param month the month (in the range 1to 12). 

* @param year the year (inthe range 1900to 9999). 

+ 

public SpreadsheetDate(final int day, final int month, final int year) { 


if((year >= 1900)&& (year <= 9999) 


this.year = year; 


j 
else ( 
throw new IllegalArgumentException( 
"[he'year argument must be in range 1900 to 9999." 
)" 
j 


if ((month >= MonthConstants JANUARY) 
&& (month <= MonthConstants. DECEMBER)) { 


this.month = month; 
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150 
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else 1 
throw new IllegalArgumentException( 


"The 'month' argument must beintherangelto 12." 


if ((day >= 1) && (day <= SerialDate.lastDayOfMonth(month, year))) { 
this.day - day; 

j 

else ( 


throw new IllegalArgumentException("Invalid 'day argument."); 


// the serial number needs to be synchronised with the day-month-year... 


this.serial = calcSerial(day, month, year); 


this.description = null; 


[RK 
* Standard constructor - creates a new date objectrepresenting the 


* specified day number (which should be in the range 2 to 2958465. 


* 


* @param serial the serial number for the day (range: 2 to 2958465). 
si) 
public SpreadsheetDate(final int serial) { 


if ((serial >= SERIAL LOWER BOUND) && (serial <= 


SERIAL UPPER BOUND)) { 


154 
155 
156 
157 
158 


this.serial — serial; 
j 
else { 
throw new IllegalArgumentException( 


"SpreadsheetDate: Serial must be in range 2to 2958465."); 


// the day-month-year needs to be synchronised with the serial number... 


calcDayMonthYear(); 


[** 

* Returns the description that is attached to the date. It is not 

* required that a date havea description, but for some applications it 
* js useful. 

* 

* @return The description that is attached to the date. 

public String getDescription() { 


return this.description; 


[ee 
* Sets the description for the date. 

* 

* @param description the description for this date (<code>null</code> 
* permitted). 

si 

public void setDescription(final String description) { 


this.description = description; 


pr 
* Returns the serial number for the date, where 1 January 1900= 2 

* (this corresponds, almost, to the numbering system used in Microsoft 
* Excel for Windows and Lotus 1-2-3). 

* 

* @return The serial number of this date. 

ssi 


194 public int toSerial() ( 


195 return this.serial; 

196 } 

197 

198 ioe 

199 * Retumsa <code>java.util.Date</code> equivalent to this date. 
200 = 

201 * @return The date. 

202 */ 

203 public Date toDate() { 

204 final Calendar calendar = Calendar.getInstance(); 
205 calendarset(getY YYY(), getMonth() -1, getDayOfMonth(), 0, 0, 0); 
206 return calendar.getTime(); 

207 } 

208 

209 [mn 

210 * Returns the year (assume a valid range of 1900 to 9999). 
211 

212 * @return The year. 

213 e 

214 public int getYYYY() ( 

215 return this.year; 

216 } 

217 

218 PES 

219 * Returns the month (January = 1, February = 2, March= 3). 
220 2 

221 * @return The month of the year. 

222 */ 

223 public int getMonth() { 

224 return this.month; 

225 } 

226 

227 Ee 


228 * Returns the day of the month. 


229 


* 


230 * @return The day of the month. 

231 */ 

232 public int getDayOfMonth() { 

233 return this.day; 

234 } 

235 

236 i 

237 * Returns a code representing the day ofthe week. 

238 * <P> 

239 * The codes are defined inthe {@link SerialDate} class as: 

240 * — <code>SUNDAY</code>, <code>MONDAY </code>, 
<code>TUESDAY </code>, 

241 *  «code»WEDNESDAY«c/code», | «code» THURSDAY «/code», 
«code» FRIDAY </code>, and 

242 * «code» SATURDAY </code>. 

243 si 

244 * @return A code representing the day ofthe week. 

245 > 

246 public int getDayOfWeek() { 

247 return (this.serial + 6)% 7+ 1; 

248 } 

249 

250 QS 

251 * Tests the equality ofthis date with an arbitrary object. 

252 * <P> 

253 * This method will return true ONLY if the objectisan instance of the 

254 * {@link SerialDate} base class, and it represents the same day as this 

255 * {@link SpreadsheetDate}. 

256 di 

257 * @param object the object to compare (<code>null</code> permitted). 

258 = 

259 * @return A boolean. 

260 ui 

261 public boolean equals(final Object object) { 
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284 
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if (object instanceof SerialDate) { 
final SerialDate s=(SerialDate) object; 
return (s.toSerial() == this.toSerial()); 


} 
else { 
return false; 
} 
} 
/炒米 


* Retums a hash code forthis object instance. 
* 

* @return A hash code. 

di 

public int hashCode() { 


return toSerial(); 


/炒米 
* Returns the difference (in days) between this date and the sp ecified 


* 'other' date. 


* 


* @param other the date being compared to. 


x 

* @return The difference (in days) between this date and the specified 
ia 'other' date. 

*/ 

public int compare(final SerialDate other) { 


return this.serial - other.toSerial(); 


[PE 


* Implements the method required by the Comparable interface. 


* 


* @param other the other object (usually another SerialDate). 

* 

* @retum A negative integer, zero, or a positive integer as this object 

a is less than, equal to, or greater than the specified object. 
* 

public int compareTo(final Object other) { 


return compare((SerialDate) other); 


/ 


* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents the same date as 


d the specified SerialDate. 

x 

public boolean isOn(final SerialDate other) { 
return (this.serial ==  other.toSerial()); 

} 

/炒米 


* Returns true if this SerialDate represents an earlier date compared to 
* the specified SerialDate. 


* 


* @param other the date being compared to. 

* 

* @return <code>true</code> if this SerialDate represents an earlier date 
* compared tothe specified SerialDate. 

*/ 

public boolean isBefore(final SerialDate other) { 


return (this.serial < other.toSerial()); 
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/[** 
* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other the date being compared to. 

x 

* @return <code>true</code> if this SerialDate represents the same date 
* as the specified SerialDate. 

x 

public boolean isOnOrBefore(final SerialDate other) { 


return (this.serial <=  other.toSerial()); 


[PE 
* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other the date being compared to. 

x 

* @return <code>true</code> if this SerialDate represents the same date 
* as the specified SerialDate. 

= 

public boolean isAfter(final SerialDate other) { 


return (this.serial > other.toSerial()); 


/炒米 
* Returns true if this SerialDate represents the same date as the 
* specified SerialDate. 


* 


* @param other the date being compared to. 


* 


* @return <code>true</code> if this SerialDate represents the same date as 


sa the specified SerialDate. 


*/ 
public boolean isOnOrAfter(final SerialDate other) { 


return (this.serial >=  other.toSerial()); 


[ee 
* Returns <code>true</code> if this {@link SerialDate} is within the 
* specified range (INCLUSIVE). The date order ofdl and  d2 is not 
* important. 

* 

* @param dl aboundary date for the range. 

* @param d2 the other boundary date for the range. 
* 

* @return A boolean. 

*/ 

public boolean isInRange(final SerialDate d1, final SerialDate d2) { 

return isInRange(d1, d2, SerialDate.,[:NCLUDE BOTH); 


Jes 
* Returns true if this SerialDate is within the specified range (caller 
* specifies whether or not the end-points are included). The order of dl 
*andd2is not important. 
* 
* @param dl one boundary date for the range. 
* @param d2 a second boundary date for the range. 
* @param include acode that controls whether or not the start and end 
* dates are included in the range. 
* 
* @return <code>true</code> if this SerialDate is within the specified 
is range. 
*/ 
public boolean isInRange(final SerialDate d1, final SerialDate d2, 
final int include) 1 


final ints1 = dl.toSerial(); 


402 final ints2 =  d2.toSerial(); 


403 final int start = Math.min(s1, s2); 

404 final intend = Math.max(s1, s2); 

405 

406 finalints=  toSerial(); 

407 if (include == SerialDate.[NCLUDE BOTH) { 

408 return (s >= start && s <= end); 

409 } 

410 else if (include == SerialDate.INCLUDE_FIRST) { 

411 return (s >= stat && s < end); 

412 } 

413 else if (include == SerialDate.INCLUDE_SECOND) { 

414 return (s> start && s <= end); 

415 } 

416 else { 

417 return (s > start && s< end); 

418 } 

419 } 

420 

421 [9x 

422 * Calculate the serial number fromthe day, month and year. 
423 * <P> 

424 * 1-Jan-1900 =2. 

425 » 

426 *@paramd the day. 

427 *@paramm the month. 

428 *(gparamy the year. 

429 = 

430 * @return the serial number from the day, month and year. 
431 n 

432 private int calcSerial(final intd, finalint m, final int y) { 
433 final int yy - ((y - 1900) * 365) + SerialDate.leapYearCount(y - 1); 
434 int mm 


SerialDate.AGGREGATE DAYS TO END OF PRECEDING. MONTH[m]; 
435 if (m > MonthConstants. FEBRUARY) { 
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if (SerialDate.isLeap Year(y)) { 


mm = mm + 1; 


} 
finalintdd = d; 


return yy - mm. +dd+ 1; 


/炒米 

* Calculate the day, month and year from the serial number. 
*/ 

private void calcDayMonthYear() { 


// get the year from the serial date 
final int days = this.serial - SERIAL_LOWER_BOUND; 
// overestimated because we ignored leap days 
final int overestimatedYYYY = 1900 + (days / 365); 
final int leaps = SerialDate.leapYearCount(overestimatedY Y Y Y); 
final int nonleapdays = days - leaps; 
// underestimated because we overestimated years 
int underestimatedYYYY = 1900 + (nonleapdays / 365); 


if (underestimatedYYYY == overestimatedY YYY) { 
this.year = underestimatedY Y YY; 


j 
else ( 
int ss1 =calcSerial(1, 1, underestimatedY Y Y Y); 
while (ss1 <= this.serial) { 
underestimatedY YYY = underestimatedY Y Y Y + 1; 
ss1 = calcSerial(1, 1, underestimatedY Y Y Y); 
j 
this.year = underestimatedYYYY - 1; 
} 


final int ss2  =calcSerial(1, 1, this.year); 


471 


472 int[] daysToEndOfPrecedingMonth 

473 = AGGREGATE DAYS TO END OF PRECEDING MONTH; 

474 

475 if (isLeap Year(this.year)) { 

476 daysToEndOfPrecedingMonth 

477 = 
LEAP_YEAR_AGGREGATE_DAYS_TO_END_OF_PRECEDING_MONTH; 

478 } 

479 

480 // get the month from the serial date 

481 int mm = 1; 

482 intsss=ss2 + daysToEndOfPrecedingMonth[mm] - 1; 

483 while (sss < this.serial) { 

484 mm=mm +1; 

485 sss = ss2 + daysToEndOfPrecedingMonth[mm] - 1; 

486 } 

487 this.month - mm - 1; 

488 

489 // what's left is d(+1); 

490 this.day =this.serial -ss2 

491 - daysToEndOfPrecedingMonth[this.month] + 1; 

492 

493 

494 

495 } 

代码 清单 B-6 RelativeDayOfWeekRule.java 

1 /* 

2 *JCommon:a free general purpose class library for the Java(tm) platform 

3 * 


5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 

6 

7 *ProjectInfo: http://www.jfree.org/jcommon/index.html 

8 

9 * This library is free software; you can redistribute it and/or modify it 

10 *underthe terms of the GNU Lesser General Public License as published by 

11 *the Free Software Foundation; either version 2.1 of the License, or 

12 *(atyouroption) any later version. 

13 * 

14 * This library is distributed inthe hope that it will be useful, but 

15 * WITHOUT ANY WARRANTY; without even the implied ^ warranty of 
MERCHANTABILITY 

16 *orFITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 

17 * License for more details. 

18 * 

19 * You should havereceiveda copy of the GNU Lesser General Public 

20 * License along with this library; if not, write tothe Free Software 

21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 

22 *USA. 

23 ak 

24 *[Java isa trademark orregistered trademark of Sun Microsystems, Inc. 

25 *inthe United States and other countries.] 

26 * 

2m We eneee 

28 * RelativeDayOfWeekRule.java 

PNE ec 

30 *(C) Copyright 2000-2003, by Object Refinery Limited and Contributors. 

3E U- 

32 * Original Author: David Gilbert (for Object Refinery Limited); 

33 * Contributor(s): -; 

34 * 

35 * $Id: RelativeDayOfWeekRule.java,v 1.6 2005/11/16 15:58:40 taqua Exp $ 

36 * 

37 * Changes (from 26-Oct-2001) 


38 


39 * 26-Oct-2001 : Changed package to com.jrefinery.date.*; 

40 * 03-Oct-2002 : Fixed errors reported by Checkstyle (DG); 

41 * 

42 */ 

43 

44 package org.jfree.date; 

45 

46 /** 

47 * Anannual date rule that returnsa date for each year based on (a) a 

48 *reference rule; (b)a day of the week; and (c) aselection parameter 

49 *(SerialDate.PRECEDING, SerialDate. NEAREST, SerialDate. FOLLOWING). 

50 * <P> 

51 *For example, Good Friday can be specified as 'the Friday PRECEDING Easter 

52 *Sunday. 

59. (# 

54 * (author David Gilbert 

55 */ 

56 public class RelativeDayOfWeekRule extends AnnualDateRule { 

57 

58 /** A reference to the annual date rule on which this rule is based. */ 

59 private AnnualDateRule subrule; 

60 

61 P ei 

62 * The day of the week  (SerialDate. MONDAY, SerialDate. TUESDAY, and so on). 

63 ui 

64 private int dayOfWeek; 

65 

66 /** Specifies which day of the week (PRECEDING, NEAREST or 
FOLLOWING). */ 

67 private int relative; 

68 

69 PES 

70 * Default constructor - builds a rule for the Monday following 1 January. 

71 */ 

72 public RelativeDayOfWeekRule() { 


73 


this(new DayAndMonthRule(), SerialDate. MONDAY, 


SerialDate.FOLLOWING); 


74 
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} 


per 
* Standard constructor - builds rule based on the supplied sub-rule. 
* 
* @param subrule the rule that determines the reference date. 
* @param dayOfWeek the day-of-the-week relative to the reference date. 
* @param relative indicates *which* day-of-the-week (preceding, nearest 
* or following). 
*/ 
public RelativeDayOfWeekRule(final AnnualDateRule subrule, 
final int dayOfWeek, final int relative) { 
this.subrule = subrule; 
this.dayOfWeek = dayOfWeek; 


this.relative = relative; 


per 
* Returns the sub-rule (also called the reference rule). 

* 

* @return The annual date rule that determines the reference date for this 
a rule. 

ui 

public AnnualDateRule getSubrule() { 


return this.subrule; 


[PE 


* Sets the sub-rule. 

x 

* @param subrule the annual date rule that determines the reference date 
di for this rule. 

ai 


107 public void setSubrule(final AnnualDateRule subrule) { 


108 this.subrule = subrule; 

109 } 

110 

111 PIS 

112 * Returns the day-of-the-week for this rule. 

113 A 

114 * @return the day-of-the-week for this rule. 

115 $y 

116 public int getDayOfWeek() { 

117 return this.dayOfWeek; 

118 } 

119 

120 ce 

121 * Sets the day-of-the-week for this rule. 

122 * 

123 * @param dayOfWeek the day-of-the-week (SerialDate MONDAY, 
124 d SerialDate. TUESDAY, and so on). 
125 zh 

126 public void setDayOfWeek(final int dayOfWeek) { 
127 this.dayOfWeek = dayOfWeek; 

128 } 

129 

130 pee 

131 * Returns the 'relative' attribute, that determines *which* 
132 * day-of-the-week we are interested in (SerialDate. PRECEDING, 
133 * SerialDate. NEAREST or SerialDate. FOLLOWING). 
134 bi 

135 * @return The 'relative' attribute. 

136 wh 

137 public int getRelative() { 

138 return this.relative; 

139 } 

140 


141 pt 


142 * Sets the 'relative' attribute (SerialDate.PRECEDING, SerialDate. NEAREST, 


143 * SerialDate.FOLLOWING). 

144 di 

145 * @param relative determines *which* day-of-the-week is selected by this 
146 2 rule. 

147 * 

148 public void setRelative(final int relative) { 

149 this.relative = relative; 

150 } 

151 

152 ea 

153 * Createsa clone of this rule. 

154 si 

155 *(gretuma clone of this rule. 

156 * 

157 * @throws CloneNotSupportedException this should never happen. 
158 */ 

159 public Object clone() throws CloneNotSupportedException { 

160 final RelativeDayOfWeekRule duplicate 

161 = (RelativeDayOfWeekRule) super.clone(); 

162 duplicate.subrule = (AnnualDateRule) duplicate.getSubrule().clone(); 
163 return duplicate; 

164 } 

165 

166 PES 

167 * Returns the date generated by this rule, for the specified year. 
168 2 

169 * @param year the year (1900 &lt; year &lt;= 9999). 

170 * 

171 * @return The date generated by the rule for the given year (possibly 
172 * <code>null</code>). 

173 */ 

174 public SerialDate getDate(final int year) { 

175 


176 // check argument... 


177 if ((year < SerialDate. MINIMUM. YEAR, SUPPORTED) 


178 || (year > SerialDatee MAXIMUM. YEAR SUPPORTED)) { 

179 throw new IllegalArgumentException( 

180 "RelativeDayOfWeekRule.getDate(): year outside valid 
range."); 

181 } 

182 

183 // calculate the date... 

184 SerialDate result = null; 

185 final SerialDate base = this.subrule.getDate(year); 

186 

187 if (base != null) { 

188 switch (this.relative) { 

189 case(SerialDate. PRECEDING): 

190 result = 
Serial Date. getPreviousDayOfWeek(this.dayOfWeek, 

191 base); 

192 break; 

193 case(SerialDate. NEAREST): 

194 result = 
Serial Date.getNearestDayOfWeek(this.dayOfWeek, 

195 base); 

196 break; 

197 case(SerialDate. FOLLOWING): 

198 result = 
Serial Date. getFollowingDayOfWeek(this.dayOfWeek, 

199 base); 

200 break; 

201 default: 

202 break; 

203 } 

204 } 

205 return result; 

206 


207 } 


208 


209 } 
代码 清单 B-7 DayDate.java (最 终 版 本 ) 
1 pe 


5 *(C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


36 */ 
37 package org.jfree.date; 
38 


39 import java.io.Serializable; 

40 import java.util.*; 

41 

42 /** 

43 * An abstract class that represents immutable dates with a precision of 
44 *oneday. The implementation will map each date to an integer that 

45 "represents an ordinal number of days from some fixed origin. 

46 * 

47 * Why not just use java.util.Date? We will, when it makes sense. At times, 
48 * java.util.Date can be *too* precise -it represents an instant in time, 

49 * accurate to 1/1000th ofa second (with the date itself dependin g on the 

50 *time-zone). Sometimes we just want to represent a particular day (e.g. 21 
51 * January 2015) without concerning ourselves about the time of day, or the 
52 *time-zone, oranythingelse. Thats what we've defined DayDate for. 

53 * 

54 * Use DayDateFactory.makeDate to create an instance. 

Spi * 

56 * @author David Gilbert 

57 * @author Robert C. Martin did alot of refactoring. 


58 */ 

59 

60 public abstract class DayDate implements Comparable, Serializable { 
61 public abstract int getOrdinalDay(); 

62 public abstract int getYear(); 

63 public abstract Month  getMonth(); 

64 public abstract int getDayOfMonth(); 


65 

66 protected abstract Day getDayOfWeekForOrdinalZero(); 

67 

68 public DayDate plusDays(int days) { 

69 return DayDateFactory.makeDate(getOrdinalDay() + days); 

70 } 

71 

72 public DayDate plusMonths(int months) { 

73 int thisMonthAsOrdinal = getMonth().toInt) - Month.JANUARY.toInt(); 

74 int thisMonthAndYearAsOrdinal = 12 * getYear() + thisMonthAsOrdinal; 

75 int resultMonthAnd YearAsOrdinal = thisMonthAndYearAsOrdinal + months; 

76 int resultYear = resultMonthAndYearAsOrdinal / 12; 

77 int resultMonthAsOrdinal=resultMonthAndYearAsOrdinal % 
12+Month. JANUARY.toIntQ); 

78 Month resultMonth = Month.fromInt(resultMonthAsOrdinal); 

79 int resultDay = correctLastDayOfMonth(getDayOfMonth(), resultMonth, 
resultYear); 

80 return DayDateFactory.makeDate(resultDay, resultMonth, resultYear); 

81 } 

82 

83 public DayDate plusYears(int years) { 

84 int resultYear = getYear() + years; 

85 int resultDay = correctLastDayOfMonth(getDayOfMonth(), getMonth(), 
resultYear); 

86 return DayDateFactory.makeDate(resultDay, getMonth(), resultYear); 

87 } 

88 


89 private int correctLastDayOfMonth(int day, Month month, int year) { 
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111 


int lastDayOfMonth = DateUtil.lastDayOfMonth(month, year); 
if (day > lastDayOfMonth) 
day = lastDayOfMonth; 


return day; 


public DayDate getPreviousDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
if (offsetToTarget >= 0) 
offsetToTarget -= 7; 
return plusDays(offsetToTarget); 


public DayDate getFollowingDayOfWeek(Day targetDayOfWeek) { 
int offsetToTarget = targetDayOfWeek.toInt() - getDayOfWeek().toInt(); 
if (offsetToTarget <= 0) 
offsetToTarget += 7; 
return plusDays(offsetToTarget); 


public DayDate getNearestDayOfWeek(Day targetDayOfWeek) { 
int  offsetToThisWeeksTarget =  targetDayOfWeek.toInt() 


getDayOfWeek().toInt(); 
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int offsetToFutureTarget = (offsetToThisWeeksTarget + 7) % 7; 


int offsetToPreviousTarget =  offsetToFutureTarget - 7; 


if (offsetToFutureTarget > 3) 
return plusDays(offsetToPreviousTarget); 
else 


return plusDays(offsetToFutureTarget); 


public DayDate getEndOfMonth() { 
Month month = getMonth(); 
int year = getYear(); 


int lastDay = DateUtil.lastDayOfMonth(month, year); 
return DayDateFactory.makeDate(lastDay, month, year); 


public Date  toDate() { 
final Calendar calendar = Calendar.getInstance(); 
int ordinalMonth = getMonth().toInt() - Month.JANUARY.toInt(); 
calendar.set(getYear(), ordinalMonth, getDayOfMonth(), 0, 0, 0); 


return calendar.getTime(); 


public String toString() { 
return String.format("%02d-%s-%d", getDayOfMonth(), getMonth(), getYear()); 


public Day getDayOfWeek() { 
Day startingDay = getDayOfWeekForOrdinalZero(); 
int startingOffset =  startingDay.toInt() - Day.SUNDAY.toInt(); 
int ordinalOfDayOfWeek = (getOrdinalDay() + startingOffset) 96 7; 
return Day.fromInt(ordinalOfDayOfWeek + Day.SUNDAY.toInt()); 


public int daysSince(DayDate date) 1 
return getOrdinalDay() - date.getOrdinalDay(); 


public boolean isOn(DayDate other) { 
return getOrdinalDay() == other.getOrdinalDay(); 


public boolean isBefore(DayDate other) { 
return getOrdinalDay() < other.getOrdinalDay(); 


public boolean isOnOrBefore(DayDate other) { 


159 return getOrdinalDay() <= other.getOrdinalDay(); 


160 } 

161 

162 public boolean isAfter(DayDate other) { 

163 return getOrdinalDay() > other.getOrdinalDay(); 

164 } 

165 

166 public boolean isOnOrAfter(DayDate other) { 

167 return getOrdinalDay() >= other.getOrdinalDay(); 

168 } 

169 

170 public boolean isInRange(DayDate d1, DayDate d2) { 

171 return isInRange(d1, d2, DateInterval. CLOSED); 

172 } 

173 

174 public boolean isInRange(DayDate d1, DayDate d2, DateInterval interval) { 
175 int left = Math.min(d1.getOrdinalDay(), d2.getOrdinalDay()); 
176 int right = Math.max(d1.getOrdinalDay(), d2.getOrdinalDay()); 
177 return interval.isIn(getOrdinalDay(), left, right); 

178 } 

179 } 


代码 清单 B-8 Month.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.text. DateFormatSymbols; 

4 

5 public enum Month { 

6 JANUARY(1), FEBRUARY(2), MARCH(3), 

7 APRIL(4), MAY(5), JUNE (6), 

8 JULY(7), AUGUST (8), SEPTEMBER(9), 

9 OCTOBER(10),NOVEMBER(11),DECEMBER(12); 
10 private static DateFormatSymbols dateFormatSymbols = new DateFormatSymbols(); 
11 private static final intl] LAST DAY OF MONTH = 
12 10, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}; 


14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 


private int index; 


Month(int index) { 


this.index = index; 


public static Month fromInt(int monthIndex) { 
for (Month m : Month.values()) ( 
if (m.index == monthIndex) 
retum m; 


} 


throw new IllegalArgumentException("Invalid month index " 


public int lastDay() 1 
return LAST DAY OF MONTH[index]; 
} 


public int quarter() 1 


return 1 + (index - 1) /3; 


public String toString() { 
return dateFormatSymbols.getMonths()[index - 1]; 


public String toShortString() 1 
return dateFormatSymbols.getShortMonths()[index  - 1]; 


public static Month parse(String s) { 
s = s.trim(); 
for (Month m : Month.values()) 
if (m.matches(s)) 


return m; 


* monthIndex); 


49 


50 try ( 

51 return fromInt(Integer.parseInt(s)); 

52 } 

53 catch (NumberFormatException e) {} 

54 throw new IllegalArgumentException("Invalid month " + s); 
55 } 

56 

57 private boolean matches(String s) { 

58 return s.equalsIgnoreCase(toString()) || 

59 s.equalsIgnoreCase(toShortString()); 
60 } 

61 

62 public int toInt() { 

63 return index; 

64 } 

65 } 


代码 清单 B-9 Day.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.util.Calendar; 

4 import java.text.DateFormatSymbols; 

5 

6 public enum Day ( 

y MONDAY (Calendar. MONDAY), 

8 TUESDAY (Calendar. TUESDAY), 

9 WEDNESDAY(Calendar. WEDNESDAY), 
10 THURSDAY (Calendar. THURSDAY), 
11 FRIDAY (Calendar.FRIDAY), 

12 SATURDAY(Calendar. SATURDAY), 
13 SUNDAY(Calendar. SUNDAY); 


14 
15 private final int index; 
16 private static DateFormatSymbols dateSymbols = new DateFormatSymbols(); 


17 


Day(intday) { 


index = day; 


public static Day fromInt(int index) throws IllegalArgumentException { 


for (Day d: Day.values()) 
if(d.index == index) 
return d; 
throw new IllegalArgumentException( 


String.format("Illegal day index: %d.", index)); 


public static Day parse(String s) throws IllegalArgumentException { 


String[] shortWeekdayNames = 
dateSymbols.getShortWeekdays(); 

String] weekDayNames = 
dateSymbols.getWeekdays(); 


s = s.trim(); 
for (Day day : Day.values()) { 
if (s.equalsIgnoreCase(shortWeekdayNames[day.index]) || 
s.equalsIgnoreCase(weekDayNames[day.index])) { 


return day; 


} 
throw new IllegalArgumentException( 


String.format("%s is not a valid weekday string", s)); 


public String toString() { 


return dateSymbols.getWeekdays()[index]; 


public int toInt() { 


return index; 


53 } 
54} 
代码 清单 B-10 DateInterval.java (最 终 版 本 ) 


1 package org.jfree.date; 


2 

3 public enum DateInterval { 

4 OPEN { 

5 public boolean isIn(int d,int left, int right) ( 
6 retund »left && d< right; 

7 j 

8 ida 

9 CLOSED LEFT ( 

10 public boolean isIn(int d, int left, int right) { 
11 return d >= left && d < right; 

12 } 

13 }, 

14 CLOSED RIGHT { 

15 public boolean isIn(int d, int left, int right) { 
16 return d > left &&d<= right; 

17 } 

18 }, 

19 CLOSED { 

20 public boolean isIn(int d, int left, int right) { 
21 return d >= left && d <= right; 

22 } 

23 }; 

24 


25 public abstract boolean isIn(int d, int left, int right); 

26 } 

代码 清单 B-11 WeekInMonth.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 public enum WeekInMonth ( 

4 FIRST(1), SECOND(2), THIRD(3), FOURTH(4), LAST(0); 


5 private final int index; 


6 

7 WeekInMonth(int index) 1 
8 this.index - index; 
9 


j 
10 
11 public int toInt() { 
12 return index; 
13 H 
14} 


代码 清单 B-12 WeekdayRange.java 《最 终 版 本 ) 
1 package org.jfree.date; 

2 

3 public enum WeekdayRange { 

4 LAST, NEAREST, NEXT 

5} 

代码 清单 B-13 DateUtiljava (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.text. DateFormatSymbols; 

4 

5 public class DateUtil { 

6 private static DateFormatSymbols dateFormatSymbols = new DateFormatSymbols(); 
7 

8 public static String[] getMonthNames() { 


9 return dateFormatS ymbols.getMonths(); 

10 } 

11 

12 public static boolean isLeapYear(int year) { 

13 boolean fourth = year 964 == 0; 

14 boolean hundredth = year % 100 == 0; 

15 boolean fourHundredth =year% 400== 0; 
16 return fourth && (!hundredth || fourHundredth); 
17 } 

18 


19 public static int lastDayOfMonth(Month month, int year) { 


20 if (month == Month.FEBRUARY &&  isLeapYear(year)) 


21 return month.lastDay() +1; 

22 else 

23 return month.lastDay(); 

24 } 

25 

26 public static int leap YearCount(int year) { 
27 int leap4 = (year - 1896)/4; 

28 int leap100 = (year - 1800)/ 100; 
29 int leap400 = (year - 1600)/ 400; 
30 return leap4 -leap100 + leap400; 
31 } 

32 } 

代码 清单 B-14 DayDateFactory.java (最 终 版 本 ) 


1 package org.jfree.date; 
2 
3 public abstract class DayDateFactory 1 


4 private static DayDateFactory factory 


DayDateFactory.factory = factory; 


= new SpreadsheetDateFactory(); 


public static void setInstance(DayDateFactory factory) { 


protected abstract DayDate _makeDate(int ordinal); 


10 protected abstract DayDate _makeDate(int day, Month month, int year); 


11 protected abstract DayDate _makeDate(int day, int month, int year); 


12 protected abstract DayDate _makeDate(java.util.Date date); 


13 protected abstract int. getMinimum Year(); 


14 protected abstract int. getMaximum Year(); 


15 

16 public static DayDate makeDate(int ordinal) { 
17 return factory. makeDate(ordinal); 

18 } 

19 


20 public static DayDate makeDate(int day, Month month, int year) { 


21 return factory._makeDate(day, month, year); 


22 } 
23 
24 public static DayDate makeDate(int day, int month, int year) { 


25 return factory. makeDate(day, month, year); 
26 } 

27 

28 public static DayDate makeDate(java.util.Date date) { 
29 return factory._makeDate(date); 

30 } 

31 

32 public static int getMinimum Year() { 

33 return factory._getMinimum Year(); 

34 } 

35 

36 public static int getMaximum Year() { 

37 return factory._getMaximum Year(); 

38 } 

39} 


代码 清单 B-15 SpreadsheetDateFactory.java (最 终 版 本 ) 

1 package org.jfree.date; 

2 

3 import java.util.*; 

4 

5 public class SpreadsheetDateFactory extends DayDateFactory { 
6 public DayDate _makeDate(int ordinal) { 


7 return new SpreadsheetDate(ordinal); 


10 public DayDate _makeDate(int day, Month month, int year) { 


11 return new SpreadsheetDate(day, month, year); 


14 public DayDate _makeDate(int day, int month, int year) { 


15 return new SpreadsheetDate(day, month, year); 


18 public DayDate _makeDate(Date date) { 

19 final GregorianCalendar calendar = new GregorianCalendar(); 

20 calendar.setTime(date); 

21 return new SpreadsheetDate( 

22 calendar.get(Calendar.D ATE), 

23 Month.fromInt(calendar.get(Calendar MONTH) + 1), 

24 calendar.get(Calendar. Y EA R)); 

25 } 

26 

27 protected int. getMinimumYear() { 

28 return SpreadsheetDate. MINIMUM YEAR, SUPPORTED; 

29 } 

30 

31 protected int. getMaximumYear() { 

32 return SpreadsheetDate. MAXIMUM, YEAR SUPPORTED; 

33] 

34 } 

代码 清单 B-16 SpreadsheetDate.java (最 终 版 本 ) 

1 p 
2 *JCommon:a free general purpose classlibrary for the Java(tm) platform 


53 


54 


* (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 


#1 


55 package org.jfree.date; 


56 


57 import static org.jfree.date. Month. FEBRUARY; 


58 

59 import java.util.*; 

60 

61 /** 

62 *Represents adate usingan integer, ina similar fashion to the 

63 *implementation in Microsoft Excel. Therange of dates supported is 

64 *1-Jan-1900 to 31-Dec-9999. 

65 *<p/> 

66 * Be aware that there is a deliberate bug in Excel that recognises the year 

67 *1900asa_ leap year when in fact itis not a leap year. You can find more 
68 * information on the Microsoft website in article Q181370: 

69 *<p/> 

70 * http://support.microsoft.com/support/kb/articl es/Q181/3/70.asp 

71 * <p> 

72 *Exceluses the convention that 1-Jan-1900= 1. This class uses the 
73 * convention 1-Jan-1900 = 2. 

74 *Theresult isthat the day number in this class will be different to the 
75 * Excel figure for January and February 1900...but then Excel adds in an extra 
76 * day (29-Feb-1900 which does not actually exist!) and from that point forward 
77 *the day numbers will match. 

78 * 

79 * @author David Gilbert 

80 */ 

81 public class SpreadsheetDate extends DayDate { 

82 public static final int EARLIEST DATE ORDINAL - 2; // 1/1/1900 

83 public static final int LATEST DATE ORDINAL - 2958465; // 12/31/9999 
84 public static final int MINIMUM YEAR SUPPORTED - 1900; 

85 public static final int MAXIMUM YEAR, SUPPORTED = 9999; 

86 static final intl] AGGREGATE DAYS TO END OF PRECEDING MONTH = 
87 (0, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365}; 

88 static final 


LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH - 


89 
90 


10, 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366}; 


int[] 


91 private int ordinalDay; 
92 private int day; 
93 private Month month; 


94 private int year; 

95 

96 public SpreadsheetDate(int day, Month month, int year) { 

97 if (year < MINIMUM YEAR SUPPORTED || year > 
MAXIMUM YEAR, SUPPORTED) 

98 throw new IllegalArgumentException( 

99 "The year argument must bein range" + 

100 MINIMUM YEAR SUPPORTED + " to " + 
MAXIMUM YEAR, SUPPORTED + "."); 

101 if(day «1 ||day>  DateUtil.lastDayOfMonth(month, year)) 

102 throw new IllegalArgumentException("Invalid 'day' argument."); 

103 

104 this.year = year; 

105 this.month = month; 

106 this.day = day; 

107 ordinalDay = calcOrdinal(day, month, year); 

108 } 

109 

110 public SpreadsheetDate(int day, int month, int year) { 

111 this(day, Month.fromInt(month), year); 

112 } 

113 


114 public SpreadsheetDate(int serial) 1 
115 if (serial < EARLIEST DATE ORDINAL || serial > LATEST DATE ORDINAL) 


116 throw new IllegalArgumentException( 

117 "SpreadsheetDate: Serial must be in range 2 to 2958465."); 
118 

119 ordinalDay = serial; 

120 calcDayMonth Year(); 

121 } 

122 


123 public int getOrdinalDay() 1 


return ordinalDay; 


public int getYear() ( 


return year; 


public Month getMonth() ( 


return month; 


public int getDayOfMonth() { 


return day; 


protected Day getDayOfWeekForOrdinalZero() (return Day.SATURDAY; } 


public boolean equals(Object object) { 
if (!(object instanceof DayDate)) 


return false; 
DayDate date = (DayDate) object; 


return date.getOrdinalDay() == getOrdinalDay(); 


public int hashCode() { 
return getOrdinalDay(); 


public int compareTo(Object other) { 
return daysSince((DayDate) other); 


private int calcOrdinal(int day, Month month, int year) { 
int leapDaysForYear = DateUtil.leapYearCount(year - 1); 


159 int daysUpToYear = (year - MINIMUM YEAR SUPPORTED) * 365 


leapDaysForYear; 

160 int daysUpToMonth 
AGGREGATE DAYS TO END OF PRECEDING MONTH[month.toInt()]; 

161 if (DateUtil.isLeapYear(year) && month.toInt() > FEBRUARY.toInt()) 

162 daysUpToMonth++; 

163 int daysInMonth = day - 1; 

164 return daysUpToYear +  daysUpToMonth +  daysInMonth 
EARLIEST DATE ORDINAL; 

165 } 

166 


167 private void calcDayMonthYear() { 
168 int days = ordinalDay - EARLIEST_DATE_ORDINAL; 


169 int overestimated Year = MINIMUM_YEAR_SUPPORTED + days / 365; 
170 int nonleapdays = days - DateUtil.leap YearCount(overestimated Year); 


171 int underestimated Year = MINIMUM_YEAR_SUPPORTED + nonleapdays / 365; 


172 

173 year = huntFor YearContaining(ordinalDay, underestimated Year); 

174 int firstOrdinalOfYear = firstOrdinalOfYear(year); 

175 month = huntForMonthContaining(ordinalDay, firstOrdinalOf Year); 

176 day =  ordinalDay - firstOrdinalOf Year - 
daysBeforeThisMonth(month.toInt()); 

177 } 

178 

179 private Month huntForMonthContaining(int anOrdinal, int firstOrdinalOfYear) 

180 int daysIntoThisYear = anOrdinal - firstOrdinalOfYear; 

181 int aMonth= 1; 

182 while (daysBeforeThisMonth(aMonth) < daysIntoThis Year) 

183 aMonth++; 

184 

185 return Month.fromInt(aMonth - 1); 

186 } 

187 


188 private int daysBeforeThisMonth(int aMonth) { 
189 if (DateUtil.isLeapYear(year)) 


+ 


190 


return 


LEAP YEAR AGGREGATE DAYS TO END OF PRECEDING MONTH[aMonth] - 1; 


191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 


else 
return AGGREGATE DAYS TO END OF PRECEDING MONTH([aMonth] - 1; 


private int huntForYearContaining(int anOrdinalDay, int startingYear) { 
intaYear-  startingYear; 
while (firstOrdinalOfYear(aYear) <= anOrdinalDay) 


aYear++; 


return aYear - 1; 


private int firstOrdinalOfYear(int year) { 
return calcOrdinal(1, Month JANUARY, year); 


public static DayDate createInstance(Date date) { 
GregorianCalendar calendar = new GregorianCalendar(); 
calendar.setTime(date); 


return new SpreadsheetDate(calendar.get(Calendar.DATE), 


Month.fromInt(calendar.get(Calendar. MONTH) + 1), 


212 


calendar.get(Calendar. YEAR)); 


结束 语 


2005 年 ， 在 参加 于 丹佛 举行 的 敏捷 大 会 时 ， Elisabeth 

Heodeson a 人 台 我 一 条 类 似 Lance Armstrong 热 销 的 那 种 绿色 胶带。 
xau Ew Se 沉迷 测试 (Test Obsessed) 的 字样 。 我 高 兴 地 戴 

上 ， 并 自豪 地 一 直系 着 。 自 从 1999 年 从 Kent Beck 那 儿 学 到 TDD 以 来 ， 
我 的 确 迷 上 了 测试 驱动 开发 。 

不 过 跟着 就 发 生 了 些 奇 事 。 我 发 现 目 己 无 法 取 下 胶带 。 不 仪 是 因 
为 腕 带 很 暴 ， 而 且 那 也 是 条 精神 上 的 紧 范 唤 。 那 脐带 就 是 我 职业 道德 
J 宜 告 ， 也 是 我 承诺 尽 己 所 能 写 出 最 好 代码 的 提示 。 取 下 它 ， 仿 佛 就 
是 违背 了 这 些 宣告 和 承诺 似 的 。 

所 以 它 还 在 我 的 手 脑 上。 在 写 代码 时 ， 我 用 余 光 盯 ° 它 一 直 
提醒 我 ， 我 做 了 写 出 整洁 代码 的 承 庄 。 


LE 


(1). JRE: http://www.qualitytree.com/ ° 


